Özellik Alanı

Komplikasyon Alanı, kadranda kullanıcı tarafından bir Özellik eklenebilecek bölümüdür. Özellik Slotları, farklı Özellik Türlerinde ve farklı kadran modlarında Özelliğin nasıl oluşturulduğunu tanımlayan Komplikasyon öğeleri içerir.

Wear OS 4'te kullanıma sunuldu.

Sözdizimi

<ComplicationSlot x="integer" y="integer" width="integer"
             height="integer" pivotX="float" pivotY="float"
             angle="float-degrees" alpha="integer" slotId="integer"
             name="string" displayName="string" scaleX="float" scaleY="float"
             supportedTypes="string" isCustomizable="boolean"
             tintColor="argb-color | rgb-color" />

Özellikler

ComplicationSlot aşağıdaki özelliklere sahiptir:

Gerekli özellikler

Aşağıdaki özellikler gereklidir:

x, y, width, height
Öğenin boyutunu ve konumunu belirten tam sayı koleksiyonu.
slotId
Alan için benzersiz bir sayısal tanımlayıcı.
supportedTypes
Alanı doldurabilecek, desteklenen Komplikasyon Türlerinin listesi. Desteklenen değerler: SHORT_TEXT, LONG_TEXT, MONOCHROMATIC_IMAGE, SMALL_IMAGE, PHOTO_IMAGE, RANGED_VALUE ve EMPTY. Boşluklarla (örneğin, SHORT_TEXT RANGED_VALUE) ayırarak birden fazla komplikasyon türü desteklenebilir.

İsteğe bağlı özellikler

Aşağıdaki özellikler isteğe bağlıdır:

pivotX, pivotY
Öğenin etrafında döndüğü iki boyutlu pivot noktasıdır. Her iki değer de $ [0, 1] $ aralığına sığacak şekilde ölçeklendirilmiş kayan nokta sayılarıdır.
angle
Öğenin, pivot noktası etrafında döndürülmesi gereken, saat yönünde bir sayı derece.
alpha
Bu öğenin sahip olması gereken şeffaflık düzeyini belirleyin. 0 değeri, öğenin tamamen şeffaf olması gerektiğini belirtir. 255 değeri, öğenin tamamen opak olması gerektiğini belirtir.
scaleX
Bu öğeye uygulanacak yatay ölçeklendirme faktörü.
scaleY
Bu öğeye uygulanacak dikey ölçeklendirme faktörü.
tintColor
Öğeye ton rengi filtresi uygulayın. Rengi, ARGB biçimini (#ff000000 = opak siyah) veya RGB biçimini (#000000 = siyah) kullanarak belirtmeniz gerekir.
displayName
Kadran düzenleyicisinde gösterilen özellik alanının yerelleştirilmiş adına karşılık gelen kaynak kimliği.
isCustomizable
Kullanıcının, kadran düzenleyicide bu alan için sağlayıcıyı değiştirip değiştiremeyeceğini belirler. Varsayılan olarak TRUE değerine ayarlanır.

İç öğeler

ComplicationSlot öğesi tam olarak bir Sınırlama Alan öğesi içermelidir.

ComplicationSlot öğesi, desteklenen Özellik Türü başına en az bir Komplikasyon öğesi içermelidir. İsteğe bağlı olarak bir ComplicationSlot öğesi, Varyant öğeleriyle görünümün değiştirilmesini desteklemek için daha fazla Complication öğesi içerebilir.

ComplicationSlot öğesi, aşağıdaki iç öğeleri de içerebilir: