CreateIcon-Funktion (winuser.h)

Artikel
03/06/2024

Erstellt ein Symbol mit der angegebenen Größe, Den angegebenen Farben und Bitmustern.

Um zur Laufzeit ein farbiges Symbol zu erstellen, können Sie die CreateIconIndirect-Funktion verwenden, die ein Symbol basierend auf dem Inhalt einer ICONINFO-Struktur erstellt.

Syntax

HICON CreateIcon(
  [in, optional] HINSTANCE  hInstance,
  [in]           int        nWidth,
  [in]           int        nHeight,
  [in]           BYTE       cPlanes,
  [in]           BYTE       cBitsPixel,
  [in]           const BYTE *lpbANDbits,
  [in]           const BYTE *lpbXORbits
);

Parameter

[in, optional] hInstance

Typ: HINSTANCE

Ein Handle zum instance des Moduls, das das Symbol erstellt.

[in] nWidth

Typ: int

Die Breite des Symbols in Pixel. Siehe Bemerkungen.

[in] nHeight

Typ: int

Die Höhe des Symbols in Pixel. Siehe Bemerkungen.

[in] cPlanes

Typ: BYTE

Die Anzahl der Ebenen in der XOR-Bitmaske des Symbols. Siehe Bemerkungen.

[in] cBitsPixel

Typ: BYTE

Die Anzahl der Bits pro Pixel in der XOR-Bitmaske des Symbols.

[in] lpbANDbits

Typ: const BYTE*

Ein Bytearray, das die Bitwerte für die AND-Bitmaske des Symbols enthält. Diese Bitmaske beschreibt eine monochrome Bitmap. Siehe Bemerkungen.

[in] lpbXORbits

Typ: const BYTE*

Ein Bytearray, das die Bitwerte für die XOR-Bitmaske des Symbols enthält. Diese Bitmaske beschreibt eine monochrome oder farbliche Bitmap. Siehe Bemerkungen.

Rückgabewert

Typ: HICON

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Handle für ein Symbol.

Wenn bei der Funktion ein Fehler auftritt, ist der Rückgabewert NULL. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Um die Nominalgröße des Symbols zu bestimmen, verwenden Sie die GetSystemMetrics-Funktion , und geben Sie den SM_CXICON oderSM_CYICON Wert an. Außerdem können Sie die DPI-fähige Version dieser API verwenden, siehe (GetSystemMetricsForDpi)(/windows/win32/api/winuser/nf-winuser-getsystemmetricsfordpi). Weitere Informationen finden Sie unter Symbolgrößen und Desktopanwendungsentwicklung mit hohem DPI-Wert unter Windows.

Weitere Informationen zu den Parametern lpbANDbits und lpbXORbits finden Sie in der Beschreibung des lpBits-Parameters der CreateBitmap-Funktion .

Bei monochromen Symbolen wendet CreateIcon die folgende Wahrheitstabelle auf die Bitmasken AND und XOR an:

UND Bitmaske	XOR-Bitmaske	Anzeige
0	0	Schwarz
0	1	White
1	0	Screen
1	1	Umgekehrter Bildschirm

Wenn Sie mit der Verwendung des Symbols fertig sind, zerstören Sie es mit der DestroyIcon-Funktion .

Beispiele

Ein Beispiel finden Sie unter Erstellen eines Symbols.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winuser.h (windows.h einschließen)
Bibliothek	User32.lib
DLL	User32.dll

Weitere Informationen

CreateIconIndirect

Symbole

Symbolgrößen

Freigeben über