Özellik Alanı

Kadran yuvası, kadran üzerinde kullanıcının komplikasyon ekleyebildiği bir alandır. Kadran komplikasyonu slotları, komplikasyonun farklı komplikasyon türleri ve farklı kadran modlarında nasıl oluşturulacağını tanımlayan komplikasyon öğeleri içerir.

Wear OS 4'te kullanıma sunulmuştur.

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ılar koleksiyonudur.
slotId
Yer için benzersiz bir sayısal tanımlayıcı.
supportedTypes
Yerleşimi doldurabilecek, desteklenen komplikasyon türlerinin listesi. Desteklenen değerler: SHORT_TEXT, LONG_TEXT, MONOCHROMATIC_IMAGE, SMALL_IMAGE, PHOTO_IMAGE, RANGED_VALUE ve EMPTY. Birden fazla komplikasyon türü, aralarına boşluk ekleyerek desteklenebilir (ör. SHORT_TEXT RANGED_VALUE).

İsteğe bağlı özellikler

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

pivotX, pivotY
Öğenin etrafında döndüğü iki boyutlu bir pivot noktası. Her iki değer de $ [0, 1] $ aralığına sığacak şekilde ölçeklendirilmiş kayan noktalı sayılardır.
angle
Öğenin, pivot noktası etrafında saat yönünde döndürülmesi gereken derece sayısı.
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 renk tonu 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 komplikasyon yuvası için yerelleştirilmiş bir ada karşılık gelen kaynak kimliği.
isCustomizable
Kullanıcının, kadran düzenleyicisinde bu yuvanın 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 Bounding Area öğesi içermelidir.

ComplicationSlot öğesi, desteklenen komplikasyon türü başına en az bir komplikasyon öğesi içermelidir. ComplicationSlot öğesi, isteğe bağlı olarak varyant öğeleriyle görünümün değiştirilmesini desteklemek için daha fazla komplikasyon öğesi içerebilir.

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