Özellik Alanı


Özellik Alanı, saat yüzünde kullanıcının bir Özellik (Komplikasyon) ekleyebileceği bir alandır. Özellik Alanları, farklı Özellik Türleri ve farklı kadran modlarında Özellik öğesinin nasıl oluşturulduğunu tanımlayan Komplikasyon öğelerini 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ıdır.
supportedTypes
Alanı doldurabilecek, desteklenen Komplikasyon Türleri'nin listesi. Desteklenen değerler şunlardır: SHORT_TEXT, LONG_TEXT, MONOCHROMATIC_IMAGE, SMALL_IMAGE, PHOTO_IMAGE, RANGED_VALUE ve EMPTY. Boşluklarla ayrılarak (örneğin, SHORT_TEXT RANGED_VALUE) 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 dönme noktası. Her iki değer de $ [0, 1] $ aralığına sığacak şekilde ölçeklendirilmiş kayan noktalı sayılardır.
angle
Öğenin dönme noktası etrafında döndürülmesi gereken, saat yönünde belirli bir derece.
alpha
Bu öğenin sahip olması gereken şeffaflık düzeyini ayarlayın. 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 bir ton rengi filtresi uygulayın. Rengi ARGB biçimini (#ff000000 = opak siyah) veya RGB biçimini (#000000 = siyah) kullanarak belirtmeniz gerekir.
displayName
Kadran düzenleyicide gösterilen, komplikasyon alanının yerelleştirilmiş adına karşılık gelen kaynak kimliği.
isCustomizable
Kullanıcının, kadran düzenleyicide bu slotun sağlayıcısını 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.

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

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