Funzione CreateIcon (winuser.h)

  • Articolo

Crea un'icona con le dimensioni, i colori e i motivi di bit specificati.

Per creare un'icona colorata in fase di esecuzione, è possibile usare la funzione CreateIconIndirect , che crea un'icona basata sul contenuto di una struttura ICONINFO .

Sintassi

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
);

Parametri

[in, optional] hInstance

Tipo: HINSTANCE

Handle per l'istanza del modulo che crea l'icona.

[in] nWidth

Tipo: int

Larghezza, in pixel, dell'icona. Vedere la sezione Osservazioni.

[in] nHeight

Tipo: int

Altezza, in pixel, dell'icona. Vedere la sezione Osservazioni.

[in] cPlanes

Tipo: BYTE

Numero di piani nella maschera di bit XOR dell'icona. Vedere la sezione Osservazioni.

[in] cBitsPixel

Tipo: BYTE

Numero di bit per pixel nella maschera di bit XOR dell'icona.

[in] lpbANDbits

Tipo: const BYTE*

Matrice di byte che contiene i valori di bit per la maschera di bit AND dell'icona. Questa maschera di bit descrive una bitmap monocromatica. Vedere la sezione Osservazioni.

[in] lpbXORbits

Tipo: const BYTE*

Matrice di byte che contiene i valori di bit per la maschera di bit XOR dell'icona. Questa maschera di bit descrive una bitmap monocromatica o color. Vedere la sezione Osservazioni.

Valore restituito

Tipo: HICON

Se la funzione ha esito positivo, il valore restituito è un handle per un'icona.

Se la funzione ha esito negativo, il valore restituito è NULL. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

Per determinare la dimensione nominale dell'icona, usare la funzione GetSystemMetrics , specificando il valore SM_CXICON o SM_CYICON . Inoltre, è possibile usare la versione compatibile con DPI di questa API, vedere (GetSystemMetricsForDpi)(/windows/win32/api/winuser/nf-winuser-getsystemmetricsfordpi). Per altre informazioni, vedere Dimensioni delle icone e Sviluppo di applicazioni desktop DPI elevate in Windows.

Per altre informazioni sui parametri lpbANDbits e lpbXORbits , vedere la descrizione del parametro lpBits della funzione CreateBitmap .

Nel caso dell'icona monocromatica CreateIcon applica la tabella verità seguente alle maschera di bit AND e XOR:

Maschera di bit AND Maschera di bit XOR Visualizza
0 0 Black
0 1 White
1 0 Screen
1 1 Schermata inversa

Al termine dell'uso dell'icona, eliminarla usando la funzione DestroyIcon .

Esempio

Per un esempio, vedere Creazione di un'icona.

Requisiti

Requisito Valore
Client minimo supportato Windows 2000 Professional [solo app desktop]
Server minimo supportato Windows 2000 Server [solo app desktop]
Piattaforma di destinazione Windows
Intestazione winuser.h (include Windows.h)
Libreria User32.lib
DLL User32.dll

Vedi anche

CreateIconIndirect

Icone

Dimensioni icona