Sintaxis de marcado de trazados

Actualización: noviembre 2007

Los trazados se explican en Información general sobre formas y dibujo básico en WPF y Información general sobre geometría; sin embargo, en este tema se describe en detalle el minilenguaje eficaz y complejo que se puede utilizar para especificar geometrías de trazado de un modo más compacto mediante Lenguaje de marcado de aplicaciones extensible (XAML).  

Este tema contiene las secciones siguientes.

Requisitos previos

Para entender este tema, debe estar familiarizado con las características básicas de los objetos Geometry. Para obtener más información, vea Información general sobre geometría.

Minilenguajes de StreamGeometry y PathFigureCollection

WPF proporciona dos clases que proporcionan minilenguajes para describir trazados geométricos: StreamGeometry y PathFigureCollection.

• El minilenguaje de StreamGeometry se utiliza para establecer propiedades de tipo Geometry, como la propiedad Clip de un elemento UIElement, o la propiedad Data de un elemento Path. En el ejemplo siguiente se utiliza la sintaxis de atributo para crear StreamGeometry.

  <Path Stroke="Black" Fill="Gray"
        Data="M 10,100 C 10,300 300,-200 300,100" />
  

• El minilenguaje de PathFigureCollection se utiliza para establecer la propiedad Figures de un elemento PathGeometry. En el ejemplo siguiente se utiliza una sintaxis de atributo para crear una colección PathFigureCollection para PathGeometry.

  <Path Stroke="Black" Fill="Gray">
    <Path.Data>
      <PathGeometry Figures="M 10,100 C 10,300 300,-200 300,100" />
    </Path.Data>
  </Path>
  

Como puede verse en los ejemplos anteriores, los dos minilenguajes son muy similares. Siempre es posible de utilizar un elemento PathGeometry en cualquier situación en que se pueda utilizar un elemento StreamGeometry; así pues, ¿cuál de ellos se debe utilizar? Utilice StreamGeometry cuando no necesite modificar el trazado después de crearlo; utilice PathGeometry en caso de que exista la necesidad de modificar el trazado.

Para obtener más información sobre las diferencias entre los objetos PathGeometry y StreamGeometry, consulte Información general sobre geometría.

Nota sobre el espacio en blanco

Para mayor brevedad, en las secciones de sintaxis que figuran a continuación se muestra un espacio simple, pero también son aceptables varios espacios en aquellos lugares donde se muestra un espacio simple.

En realidad, no es preciso que dos números estén separados por una coma o espacio en blanco, pero únicamente se pueden omitir cuando la cadena resultante es inequívoca. Por ejemplo, 2..3 representa en la realidad dos números: “2.” y “.3”. Igualmente, 2-3 es “2” y “-3”. Tampoco se necesitan espacios antes ni después de los comandos.

Sintaxis

La sintaxis de uso de atributos de Lenguaje de marcado de aplicaciones extensible (XAML) de un objeto StreamGeometry está compuesta de un valor FillRule opcional y de una o más descripciones de figuras.

La sintaxis de uso de atributos de Lenguaje de marcado de aplicaciones extensible (XAML) para una colección PathFigureCollection está compuesta de una o más descripciones de figuras.

Comando de movimiento

Especifica el punto de inicio de una nueva figura.

Una M mayúscula indica que startPoint es un valor absoluto; una m minúscula indica que startPoint es un desplazamiento con respecto al punto anterior, o (0,0) si este último no existe. Si enumera varios puntos después del comando de movimiento, se dibuja una línea por ellos como si se hubiera especificado el comando de línea.

Comandos de dibujo

Un comando de dibujo puede estar compuesto de varios comandos de forma. Están disponibles los comandos de forma siguientes: línea, línea horizontal, línea vertical, curva Bézier cúbica, curva Bézier cuadrática, curva Bézier cúbica suavizada, curva Bézier cuadrática suavizada y arco elíptico.

Cada comando se escribe con una mayúscula o una minúscula. Las letras mayúsculas denotan valores absolutos y las minúsculas, valores relativos: los puntos de control para ese segmento son relativos al punto final del ejemplo anterior. Cuando se escribe secuencialmente más de un comando del mismo tipo, no es necesario escribir el comando para cada entrada; por ejemplo, L 100,200 300,400 es equivalente a L 100,200 L 300,400. En la tabla siguiente se describen los comandos de dibujo (draw) y de movimiento (move).

Comando de línea

Crea una línea recta entre el punto actual y el punto final especificado. l 20 30 y L 20,30 son ejemplos de comandos de línea (line) válidos.

Comando de línea horizontal

Crea una línea horizontal entre el punto actual y la coordenada X especificada. H 90 es un ejemplo de un comando de línea horizontal válido.

Comando de línea vertical

Crea una línea vertical entre el punto actual y la coordenada Y especificada. v 90 es un ejemplo de un comando de línea vertical válido.

Comando de curva Bézier cúbica

Crea una curva Bézier cúbica entre el punto actual y el punto final especificado utilizando los dos puntos de control especificados (controlPoint₁ y controlPoint₂). C 100,200 200,400 300,200 es un ejemplo de un comando de curva válido.

Comando de curva Bézier cuadrática

Crea una curva Bézier cuadrática entre el punto actual y el punto final especificado utilizando el punto de control especificado (controlPoint). q 100,200 300,200 es un ejemplo de un comando de curva Bézier cuadrática válido.

Comando de curva Bézier cúbica suavizada

Crea una curva Bézier cúbica entre el punto actual y el punto final especificado. Se da por hecho que el primer punto de control es la reflexión del segundo punto de control del comando anterior en relación con el punto actual. Si no hay ningún comando anterior o si el comando anterior no es un comando de curva Bézier cúbica o cúbica suavizada, se dará por hecho que el primer punto de control coincide con el punto actual. El segundo punto de control, el punto de control del final de la curva, se especifica mediante controlPoint₂. Por ejemplo, S 100,200 200,300 es un comando de curva Bézier cúbica suavizada válido.

Comando de curva Bézier cuadrática suavizada

Crea una curva Bézier cuadrática entre el punto actual y el punto final especificado. Se da por hecho que el punto de control es la reflexión del punto de control del comando anterior en relación con el punto actual. Si no hay ningún comando anterior o si el comando anterior no es un comando de curva Bézier cuadrática o cuadrática suavizada, se dará por hecho que el primer punto de control coincide con el punto actual.

Comando de arco elíptico

Crea un arco elíptico entre el punto actual y el punto final especificado.

Comando de cierre

Finaliza la figura actual y crea una línea que conecta el punto actual al punto inicial de la figura. Este comando crea una unión de línea (esquina) entre el último segmento y el primer segmento de la figura.

Sintaxis de puntos

Describe las coordenadas X e Y de un punto.

Valores especiales

En lugar de un valor numérico estándar, puede utilizar también los valores especiales siguientes. Estos valores distinguen mayúsculas de minúsculas.

• Infinity
  Representa Double.PositiveInfinity.

• -Infinity
  Representa Double.NegativeInfinity.

• NaN
  Representa Double.NaN.

También puede utilizar la notación científica. Por ejemplo, +1.e17 es un valor válido.

Vea también

Conceptos

Información general sobre formas y dibujo básico en WPF

Información general sobre geometría

Referencia

Path

StreamGeometry

PathGeometry

PathFigureCollection

Otros recursos

Temas "Cómo..." de objetos de geometría

Ejemplos de objetos de geometría

Ejemplos de formas