ImageList.ColorDepth Eigenschaft

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Ruft die Farbtiefe der Bildliste ab oder legt diese fest.

public:
 property System::Windows::Forms::ColorDepth ColorDepth { System::Windows::Forms::ColorDepth get(); void set(System::Windows::Forms::ColorDepth value); };

public System.Windows.Forms.ColorDepth ColorDepth { get; set; }

member this.ColorDepth : System.Windows.Forms.ColorDepth with get, set

Public Property ColorDepth As ColorDepth

Eigenschaftswert

ColorDepth

Die Anzahl der für das Bild verfügbaren Farben. In .NET Framework- und .NET-Versionen (Core) über .NET 7 ist Depth8Bitder Standardwert . In .NET 8 und höheren Versionen ist Depth32Bitder Standardwert .

Ausnahmen

InvalidEnumArgumentException

Die Farbtiefe ist kein gültiger ColorDepth-Enumerationswert.

Hinweise

Wenn Sie die Farbtiefe auf einen neuen Wert festlegen, wird die Handle für die Bildliste neu erstellt. Da das Festlegen der ColorDepth Eigenschaft bewirkt, dass das Handle neu erstellt wird, sollten Sie vor dem Festlegen der Images Eigenschaft festlegenColorDepth. Wenn das Handle für erstellt ImageList wurde, bewirkt das Festlegen der ColorDepth Eigenschaften oder ImageSize im Code nach dem Festlegen der Images -Eigenschaft, dass die Sammlung von Bildern, die für die Images Eigenschaft festgelegt wurden, gelöscht wird.

Weitere Informationen

• ColorDepth