Vcl.Graphics.TCustomCanvas.Pixels

• Übergeordnet: TCustomCanvas

Delphi

property Pixels[X, Y: Integer]: TColor read GetPixel write SetPixel;

C++

__property System::Uitypes::TColor Pixels[int X][int Y] = {read=GetPixel, write=SetPixel};

Eigenschaften

Typ	Sichtbarkeit	Quelle	Unit	Übergeordnet
property	public	Vcl.Graphics.pas Vcl.Graphics.hpp	Vcl.Graphics	TCustomCanvas

Beschreibung

Gibt die Farbe der Pixel innerhalb des aktuellen Begrenzungsrechtecks an.

Mit einem Lesezugriff auf Pixels können Sie ermitteln, welche Farbe die Zeichenfläche an einer bestimmten Stelle des aktuellen Begrenzungsbereichs hat. Wenn sich die Position außerhalb des Begrenzungsrechtecks befindet, liefert das Auslesen der Eigenschaft Pixels den Wert -1.

Ein Schreibzugriff auf Pixels ändert die Farbe eines einzelnen Pixel auf der Zeichenfläche. Sie können mit dieser Eigenschaft also gezielte Änderungen an einem Bild vornehmen. Außerdem lässt sich über Pixels die Farbe festlegen, die für die Methode FillRect verwendet werden soll.

Beachten Sie, dass die Eigenschaft Pixels nicht von jedem Gerätekontext unterstützt wird. Wenn der vorliegende Gerätekontext die Eigenschaft Pixels nicht unterstützt, gibt ein Lesezugriff den Wert -1 zurück. Die Zuweisung eines Wertes bleibt ohne Wirkung.

Siehe auch

• ClipRect

• Handle

• FillRect

Codebeispiele

• Pixels (Delphi)
• Pixels (C++)