Steckplatz für Zusatzfunktionen

Ein Slot für Zusatzfunktionen ist ein Bereich auf dem Zifferblatt, in dem der Nutzer eine Zusatzfunktion hinzufügen kann. Slots für Zusatzfunktionen enthalten Elemente vom Typ Zusatzfunktion, die festlegen, wie die Zusatzfunktion für verschiedene Zusatzfunktionen und in verschiedenen Zifferblattmodi gerendert wird.

Mit Wear OS 4 eingeführt.

Syntax

<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" />

Merkmale

ComplicationSlot hat die folgenden Attribute:

Erforderliche Attribute

Die folgenden Attribute sind erforderlich:

x, y, width, height
Eine Sammlung von Ganzzahlen, die die Größe und Position des Elements angeben.
slotId
Eine eindeutige numerische Kennung für den Slot.
supportedTypes
Eine Liste der unterstützten Zusatztypen, die in den Slot aufgenommen werden können. Unterstützte Werte sind SHORT_TEXT, LONG_TEXT, MONOCHROMATIC_IMAGE, SMALL_IMAGE, PHOTO_IMAGE, RANGED_VALUE und EMPTY. Sie können mehrere Zusatzfunktionen unterstützen, indem Sie sie durch ein Leerzeichen trennen (z. B. SHORT_TEXT RANGED_VALUE).

Optionale Attribute

Die folgenden Attribute sind optional:

pivotX, pivotY
Ein zweidimensionaler Drehpunkt, um den sich das Element dreht. Beide Werte sind Gleitkommazahlen, die so skaliert werden, dass sie in den Bereich $ [0, 1] $ passen.
angle
Ein Wert in Grad im Uhrzeigersinn, um den das Element um seinen Drehpunkt gedreht werden soll.
alpha
Legen Sie die Transparenz für dieses Element fest. Der Wert 0 gibt an, dass das Element vollständig transparent sein soll. Der Wert 255 gibt an, dass das Element vollständig deckend sein soll.
scaleX
Der horizontale Skalierungsfaktor, der auf dieses Element angewendet wird.
scaleY
Der vertikale Skalierungsfaktor, der auf dieses Element angewendet wird.
tintColor
Färben Sie das Element mit einem Farbfilter aus. Sie müssen die Farbe entweder im ARGB-Format (#ff000000 = opaken Schwarz) oder im RGB-Format (#000000 = Schwarz) angeben.
displayName
Eine Ressourcen-ID, die einem lokalisierten Namen für den Slot der Zusatzfunktion entspricht und im Zifferblatt-Editor angezeigt wird.
isCustomizable
Bestimmt, ob ein Nutzer den Anbieter für diesen Slot im Zifferblatt-Editor ändern kann. Die Standardeinstellung ist TRUE.

Innere Elemente

Das Element ComplicationSlot muss genau ein Element vom Typ Begrenzungsbereich enthalten.

Ein ComplicationSlot-Element muss pro unterstütztem Zusatzfunktionstyp mindestens ein Zusatzelement enthalten. Ein ComplicationSlot-Element kann optional weitere Complication-Elemente enthalten, um das Ändern der Darstellung mit Variant-Elementen zu unterstützen.

Das ComplicationSlot-Element kann auch die folgenden inneren Elemente enthalten: