Pen.CompoundArray Propriedade

Definição

Namespace:

System.Drawing

Assembly:

System.Drawing.Common.dll

Origem:

Pen.cs

Obtém ou define uma matriz de valores que especifica uma caneta composta. Uma caneta composta desenha uma linha composta composta de linhas e espaços paralelos.

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 da propriedade

Single[]

Uma matriz de números reais que especifica a matriz composta. Os elementos na matriz devem estar em ordem crescente, não menor que 0 e não maiores que 1.

Exceções

ArgumentException

A CompoundArray propriedade é definida em um imutável Pen, como os retornados pela Pens classe.

Comentários

Uma linha composta é composta por linhas paralelas alternadas e espaços de larguras variadas. Os valores na matriz especificam os pontos iniciais de cada componente da linha composta em relação à largura da caneta. O primeiro valor na matriz especifica onde o primeiro componente (uma linha) começa como uma fração da distância na largura da caneta. O segundo valor na matriz especifica o início do próximo componente (um espaço) como uma fração da distância na largura da caneta. O valor final na matriz especifica onde o último componente termina.

Suponha que você queira que uma caneta desenhe duas linhas paralelas em que a largura da primeira linha seja 20% da largura da caneta, a largura do espaço que separa as duas linhas é 50% da largura da caneta e a largura da segunda linha é 30% da largura da caneta. Comece criando um e uma Pen matriz de números reais. Defina a matriz composta passando a matriz com os valores 0.0, 0.2, 0.7 e 1.0 para essa propriedade.

Não defina essa propriedade se a Pen propriedade tiver sua Alignment propriedade definida como Inset.