Funzione CreateIcon (winuser.h)
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 |