Begrenzungsbereiche für Komplikationen

Begrenzungsbereiche für Zusatzfunktionen werden verwendet, um den Renderingbereich für eine Zusatzfunktion zu definieren. Im Zifferblatt-Editor 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.

Eingeführt in Wear OS 4.

Begrenzungsrahmen

Ein BoundingBox-Element definiert einen rechteckigen Begrenzungsbereich für die Zusatzfunktion.

Syntax

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

Merkmale

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
Eine Gleitkommazahl, die den Abstand außerhalb des Begrenzungsbereichs angibt. Dadurch wird ein größerer Umriss im Zifferblatt-Editor erstellt. Die Standardeinstellung ist 0.

Begrenzungsrahmen

Ein BoundingRoundBox-Element definiert einen rechteckigen Begrenzungsbereich mit abgerundeten Ecken für die Zusatzfunktion.

Syntax

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

Merkmale

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 Dieser Wert definiert, wie stark die Ecken des Rechtecks abgerundet werden.

outlinePadding
Eine Gleitkommazahl, die den Abstand außerhalb des Begrenzungsbereichs angibt. Dadurch wird ein größerer Umriss im Zifferblatt-Editor erstellt. Die Standardeinstellung ist 0.

Begrenzungsrahmen

Ein BoundingOval-Element definiert einen runden Begrenzungsbereich für die Zusatzfunktion.

Syntax

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

Merkmale

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
Eine Gleitkommazahl, die den Abstand außerhalb des Begrenzungsbereichs angibt. Dadurch wird ein größerer Umriss im Zifferblatt-Editor erstellt. Die Standardeinstellung ist 0.

BoundingArc

Ein BoundingArc-Element definiert einen bogenförmigen Begrenzungsbereich für die Zusatzfunktion.

Syntax

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

Merkmale

Das BoundingArc-Element hat die folgenden Attribute:

Erforderliche Attribute

Die folgenden Attribute sind erforderlich:

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

Optionale Attribute

Die folgenden Attribute sind optional:

isRoundEdge
Bestimmt, ob das Ende des Bogens flach oder abgerundet ist. Die Standardeinstellung ist FALSE.
direction
Die Drehrichtung des Bogens. Die Standardeinstellung ist CLOCKWISE.
outlinePadding
Eine Gleitkommazahl, die den Abstand außerhalb des Begrenzungsbereichs angibt. Dadurch wird ein größerer Umriss im Zifferblatt-Editor erstellt. Die Standardeinstellung ist 0.