Pen.CompoundArray Eigenschaft

Definition

Namespace:

System.Drawing

Assembly:

System.Drawing.Common.dll

Quelle:

Pen.cs

Dient zum Abrufen oder Festlegen eines Arrays von Werten, das einen zusammengesetzten Stift angibt. Ein zusammengesetzter Stift zeichnet eine zusammengesetzte Linie aus parallelen Linien und Leerzeichen.

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 mit reellen Zahlen, das das zusammengesetzte Array angibt. Die Elemente im Array müssen in erhöhter Reihenfolge, nicht kleiner als 0 und nicht größer als 1 sein.

Ausnahmen

ArgumentException

Die CompoundArray Eigenschaft wird für eine unveränderliche PenEigenschaft festgelegt, z. B. die von der Pens Klasse zurückgegebenen.

Hinweise

Eine zusammengesetzte Linie besteht aus abwechselnden parallelen Linien und Leerzeichen 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, ein Stift soll zwei parallele Linien zeichnen, wobei die Breite der ersten Zeile 20 Prozent der Stiftbreite beträgt, die Breite des Abstands, der die beiden Linien trennt, 50 Prozent der Breite des Stifts und die Breite der zweiten Zeile beträgt 30 Prozent der Breite des Stifts. Erstellen Sie zunächst ein Pen Array mit reellen Zahlen. Legen Sie das zusammengesetzte Array 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 PenAlignment Eigenschaft auf Inset.