Begrenzungsbereiche für Komplikationen

Mit Begrenzungsbereichen für Zusatzfunktionen wird der Renderingbereich für eine Zusatzfunktion definiert. Im Zifferblatteditor wird ein Umriss des Begrenzungsbereichs angezeigt. Inhalte außerhalb des Begrenzungsbereichs werden abgeschnitten.

Der Begrenzungsbereich bestimmt auch den Bereich, in dem der Nutzer die Zusatzfunktion auf dem Zifferblatt auswählen kann.

In Wear OS 4 eingeführt.

Bounding_box

Mit einem BoundingBox-Element wird ein rechteckiger Begrenzungsbereich für die Zusatzfunktion definiert.

Syntax

<BoundingBox x="integer" y="integer" width="integer" height="integer"
                outlinePadding="float" />

Attribute

Das BoundingBox-Element 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.

Optionale Attribute

Die folgenden Attribute sind optional:

outlinePadding
Ein Float, das den Abstand angibt, der außerhalb des Begrenzungsbereichs angewendet werden soll. Damit wird im Zifferblatt-Editor ein größerer Umriss erstellt. Die Standardeinstellung ist 0.

BoundingRoundBox

Mit einem BoundingRoundBox-Element wird ein rechteckiger Begrenzungsbereich mit abgerundeten Ecken für die Zusatzfunktion definiert.

Syntax

<BoundingRoundBox x="integer" y="integer" width="integer" height="integer"
                outlinePadding="float" cornerRadius="float" />

Attribute

Das BoundingRoundBox-Element 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.

Optionale Attribute

Die folgenden Attribute sind optional:

cornerRadius

Der Radius eines Kreises. Mit diesem Wert wird festgelegt, wie stark die Ecken des Rechtecks abgerundet werden.

outlinePadding
Ein Float, das den Abstand angibt, der außerhalb des Begrenzungsbereichs angewendet werden soll. Damit wird im Zifferblatt-Editor ein größerer Umriss erstellt. Die Standardeinstellung ist 0.

BoundingOval

Mit einem BoundingOval-Element wird ein runder Begrenzungsbereich für die Zusatzfunktion definiert.

Syntax

<BoundingOval x="integer" y="integer" width="integer" height="integer"
                outlinePadding="float" />

Attribute

Das BoundingOval-Element 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.

Optionale Attribute

Die folgenden Attribute sind optional:

outlinePadding
Ein Float, das den Abstand angibt, der außerhalb des Begrenzungsbereichs angewendet werden soll. Damit wird im Zifferblatteditor ein größerer Umriss erstellt. Die Standardeinstellung ist 0.

BoundingArc

Mit einem BoundingArc-Element wird ein bogenförmiger Begrenzungsbereich für die Zusatzfunktion definiert.

Syntax

<BoundingArc centerX="float" centerY="float" width="float"
                height="float" thickness="float" isRoundEdge="boolean"
                startAngle="float" endAngle="float"
                direction="CLOCKWISE | COUNTER_CLOCKWISE"
                outlinePadding="float" />

Attribute

Das BoundingArc-Element hat die folgenden Attribute:

Erforderliche Attribute

Die folgenden Attribute sind erforderlich:

centerX, centerY, width, height
Eine Sammlung von Attributen, die ein Oval für den Bogen definieren. Der Bogen wird so skaliert, dass er in das angegebene Oval passt. Alle Attribute sind als Gleitkommazahlen definiert.
thickness
Die Dicke des Bogens als Gleitkommazahl.
startAngle
Der Startwinkel (in Grad), an dem der Bogen beginnt. Ein Winkel von 0 Grad entspricht der Position „12 Uhr“ auf der Smartwatch.
endAngle
Endwinkel, an dem der Bogen endet.

Optionale Attribute

Die folgenden Attribute sind optional:

isRoundEdge
Bestimmt, ob der Abschluss am Ende des Bogens flach oder abgerundet ist. Standardmäßig ist FALSE festgelegt.
direction
Die Drehrichtung des Bogens. Die Standardeinstellung ist CLOCKWISE.
outlinePadding
Ein Float, das den Abstand angibt, der außerhalb des Begrenzungsbereichs angewendet werden soll. Damit wird im Zifferblatt-Editor ein größerer Umriss erstellt. Die Standardeinstellung ist 0.