Pen.CompoundArray Eigenschaft

Definition

Namespace:

System.Drawing

Assembly:

System.Drawing.Common.dll

Paket:

System.Drawing.Common v8.0.0

Quelle:

Pen.cs

Ruft ein Array von Werten ab, das einen Verbundstift angibt, oder legt dieses fest. Ein Verbundstift zeichnet eine Verbundlinie, die aus parallelen Linien und Zwischenräumen besteht.

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()

Eigenschaftswert

Single[]

Ein Array reeller Zahlen, das das Verbundarray angibt. Die Elemente des Arrays müssen aufsteigend sortiert und dürfen nicht kleiner als 0 und nicht größer als 1 sein.

Ausnahmen

ArgumentException

Die CompoundArray-Eigenschaft wird auf einen unveränderlichen Pen festgelegt, der z. B. von der Pens-Klasse zurückgegeben wird.

Hinweise

Eine zusammengesetzte Linie besteht aus wechselnden parallelen Linien und Räumen unterschiedlicher Breite. Die Werte im Array geben die Startpunkte jeder Komponente der Verbundlinie relativ zur Breite des Stifts an. Der erste Wert im Array gibt an, wo die erste Komponente (eine Zeile) als Bruchteil des Abstands über die Breite des Stifts beginnt. Der zweite Wert im Array gibt den Anfang der nächsten Komponente (ein Leerzeichen) als Bruchteil des Abstands über die Breite des Stifts an. Der letzte Wert im Array gibt an, wo die letzte Komponente endet.

Angenommen, Sie möchten, dass ein Stift zwei parallele Linien zeichnen soll, wobei die Breite der ersten Zeile 20 Prozent der Breite des Stifts beträgt, die Breite des Abstands, der die beiden Linien trennt, 50 Prozent der Breite des Stifts und die Breite der zweiten Zeile 30 Prozent der Breite des Stifts. Erstellen Sie zunächst ein Pen - und ein Array von reellen Zahlen. Legen Sie das Verbundarray fest, indem Sie das Array mit den Werten 0.0, 0.2, 0.7 und 1.0 an diese Eigenschaft übergeben.

Legen Sie diese Eigenschaft nicht fest, wenn die Pen - Alignment Eigenschaft auf Insetfestgelegt ist.