Pen.CompoundArray Propriedade

Definição

Namespace:

System.Drawing

Assembly:

System.Drawing.Common.dll

Pacote:

System.Drawing.Common v8.0.0

Origem:

Pen.cs

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

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 especificam a matriz composta. Os elementos na matriz devem estar em ordem crescente, não serem menor que 0 nem maiores que 1.

Exceções

ArgumentException

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

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 entre a 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 entre a 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 é de 20% da largura da caneta, a largura do espaço que separa as duas linhas é de 50% da largura da caneta e a largura da segunda linha é de 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 tiver sua Alignment propriedade definida como Inset.