Áreas de límite de complicaciones


Las áreas de límite de complicaciones se usan para definir el área de renderización de una complicación. En el editor de caras de reloj, se muestra un contorno del área de límite. Se recorta todo el contenido fuera del área de límite.

El área de límite también determina la región en la que el usuario puede seleccionar la complicación de la cara de reloj.

Se introdujo en Wear OS 4.

BoundingBox

Un elemento BoundingBox define un área de límite rectangular para la complicación.

Sintaxis

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

Atributos

El elemento BoundingBox tiene los siguientes atributos:

Atributos obligatorios

Se requieren los siguientes atributos:

x, y, width y height
Es una colección de números enteros que especifican el tamaño y la posición del elemento.

Atributos opcionales

Los siguientes atributos son opcionales:

outlinePadding
Es un número de punto flotante que especifica el relleno que se aplicará al exterior del área de límite. Se usa para crear un contorno más grande en el editor de caras de reloj. La configuración predeterminada es 0.

BoundingRoundBox

Un elemento BoundingRoundBox define un área de límite rectangular con esquinas redondeadas para la complicación.

Sintaxis

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

Atributos

El elemento BoundingRoundBox tiene los siguientes atributos:

Atributos obligatorios

Se requieren los siguientes atributos:

x, y, width y height
Es una colección de números enteros que especifican el tamaño y la posición del elemento.

Atributos opcionales

Los siguientes atributos son opcionales:

cornerRadius

El radio de un círculo. Este valor define hasta qué punto se redondean las esquinas del rectángulo.

outlinePadding
Es un número de punto flotante que especifica el relleno que se aplicará al exterior del área de límite. Se usa para crear un contorno más grande en el editor de caras de reloj. La configuración predeterminada es 0.

BoundingOval

Un elemento BoundingOval define un área de límite redonda para la complicación.

Sintaxis

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

Atributos

El elemento BoundingOval tiene los siguientes atributos:

Atributos obligatorios

Se requieren los siguientes atributos:

x, y, width y height
Es una colección de números enteros que especifican el tamaño y la posición del elemento.

Atributos opcionales

Los siguientes atributos son opcionales:

outlinePadding
Es un número de punto flotante que especifica el relleno que se aplicará al exterior del área de límite. Se usa para crear un contorno más grande en el editor de caras de reloj. La configuración predeterminada es 0.

BoundingArc

Un elemento BoundingArc define un área de límite con forma de arco para la complicación.

Sintaxis

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

Atributos

El elemento BoundingArc tiene los siguientes atributos:

Atributos obligatorios

Se requieren los siguientes atributos:

centerX, centerY, width y height
Es una colección de atributos que definen un óvalo contenedor para el arco. El arco se ajusta para adaptarse al óvalo especificado. Todos los atributos se definen como números de punto flotante.
thickness
El espesor del arco expresado como número de punto flotante.
startAngle
Ángulo inicial (en grados) donde comienza el arco. Un ángulo de 0 grados corresponde a la posición de las 12 en punto del reloj.
endAngle
Ángulo final donde finaliza el arco.

Atributos opcionales

Los siguientes atributos son opcionales:

isRoundEdge
Determina si el límite al final del arco es plano o redondeado. La configuración predeterminada es FALSE.
direction
Es la dirección de rotación del arco. La configuración predeterminada es CLOCKWISE.
outlinePadding
Es un número de punto flotante que especifica el relleno que se aplicará al exterior del área de límite. Se usa para crear un contorno más grande en el editor de caras de reloj. La configuración predeterminada es 0.