Freigeben über


ImageList.ColorDepth Eigenschaft

Definition

Ruft die Farbtiefe der Bildliste ab oder legt sie 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

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

Ausnahmen

Die Farbtiefe ist kein gültiger ColorDepth Enumerationswert.

Hinweise

Wenn Sie die Farbtiefe auf einen neuen Wert festlegen, wird die Handle 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 das ImageList Objekt erstellt wurde, wird das Festlegen der ColorDepth Eigenschaften oder ImageSize Eigenschaften im Code nach dem Festlegen der Images Eigenschaft dazu führen, dass die Sammlung von Bildern, die für die Images Eigenschaft festgelegt wurden, gelöscht wird.

Gilt für:

Weitere Informationen