Pen.CompoundArray Propiedad

Definición

Obtiene o establece una matriz de valores que especifica un lápiz compuesto.Gets or sets an array of values that specifies a compound pen. Un lápiz compuesto dibuja una línea compuesta formada por líneas y espacios paralelos.A compound pen draws a compound line made up of parallel lines and spaces.

public:
 property cli::array <float> ^ CompoundArray { cli::array <float> ^ get(); void set(cli::array <float> ^ value); };
public float[] CompoundArray { get; set; }
member this.CompoundArray : single[] with get, set
Public Property CompoundArray As Single()

Valor de propiedad

Single[]

Matriz de números reales que especifica la matriz compuesta.An array of real numbers that specifies the compound array. Los elementos de la matriz deben estar en orden ascendente, no menor que cero y no mayor que 1.The elements in the array must be in increasing order, not less than 0, and not greater than 1.

Excepciones

El valor de la propiedad CompoundArray se establece en un objeto Pen inmutable, como los devueltos por la clase Pens.The CompoundArray property is set on an immutable Pen, such as those returned by the Pens class.

Comentarios

Una línea compuesta se compone de líneas paralelas alternativas y espacios de distintos anchos.A compound line is made up of alternating parallel lines and spaces of varying widths. Los valores de la matriz especifican los puntos de inicio de cada componente de la línea compuesta con respecto al ancho del lápiz.The values in the array specify the starting points of each component of the compound line relative to the pen's width. El primer valor de la matriz especifica dónde comienza el primer componente (una línea) como una fracción de la distancia en el ancho del lápiz.The first value in the array specifies where the first component (a line) begins as a fraction of the distance across the width of the pen. El segundo valor de la matriz especifica el principio del componente siguiente (un espacio) como fracción de la distancia en el ancho del lápiz.The second value in the array specifies the beginning of the next component (a space) as a fraction of the distance across the width of the pen. El valor final de la matriz especifica dónde finaliza el último componente.The final value in the array specifies where the last component ends.

Imagine que desea que un lápiz dibuje dos líneas paralelas en las que el ancho de la primera línea sea el 20 por ciento del ancho del lápiz, el ancho del espacio que separa las dos líneas es el 50 por ciento del ancho del lápiz y el ancho de la segunda línea es el 30 por ciento del ancho del lápiz.Suppose you want a pen to draw two parallel lines where the width of the first line is 20 percent of the pen's width, the width of the space that separates the two lines is 50 percent of the pen' s width, and the width of the second line is 30 percent of the pen's width. Empiece por crear un Pen y una matriz de números reales.Start by creating a Pen and an array of real numbers. Establezca la matriz compuesta pasando la matriz con los valores 0,0, 0,2, 0,7 y 1,0 a esta propiedad.Set the compound array by passing the array with the values 0.0, 0.2, 0.7, and 1.0 to this property.

No establezca esta propiedad si Pen tiene su Alignment propiedad establecida en Inset .Do not set this property if the Pen has its Alignment property set to Inset.

Se aplica a