Vcl.Graphics.TCustomCanvas.Pixels

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

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

Codebeispiele