CreateIcon

La funzione CreateIcon crea un'icona che ha la dimensione specificata, i colori e schemi di bit.

(HICON CreateIcon HINSTANCE , hInstance, / / handle all'istanza dell'applicazioneintnWidth, / / larghezza iconaintnHeight, / / altezza iconaBYTEcPlanes, / / numero di aerei nella maschera di bit XORBYTEcBitsPixel, / / numero di bit per pixel in maschera di bit XORCONST BYTE* lpbANDbits, / / puntatore a matrice di maschera di bit eCONST BYTE* lpbXORbits / / puntatore a matrice di maschera di bit XOR);
 

Parametri

hInstance
Gestire all'istanza del modulo creando l'icona.
nWidth
Specifica la larghezza in pixel, dell'icona.
nHeight
Specifica l'altezza, in pixel, dell'icona.
cPlanes
Specifica il numero di aerei nella maschera di bit XOR dell'icona.
cBitsPixel
Specifica il numero di bit per pixel nella maschera di bit XOR dell'icona.
lpbANDbits
Puntatore a una matrice di byte che contiene i valori di bit per la maschera di bit e dell'icona. Questa maschera di bit descrive una bitmap in bianco e nero.
lpbXORbits
Puntatore a una matrice di byte che contiene i valori di bit per la maschera di bit XOR dell'icona. Questa maschera di bit descrive un bianco e nero o colore dipendenti dalla periferica bitmap.

Valori restituiti

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 ottenere informazioni di errore estese, chiamare GetLastError.

Osservazioni

I parametri nWidth e nHeight necessario specificare una larghezza e un'altezza supportate dal driver visualizzazione corrente, perché il sistema non è possibile creare icone di altre dimensioni. Per determinare la larghezza e l'altezza supportate dal driver visualizzazione, utilizzare il funzione GetSystemMetrics , specificando il valore SM_CXICON o SM_CYICON.

CreateIcon si applica la seguente tabella di verità fino al e e maschere di XOR bit:

E maschera di bit Maschera di bit XOR Visualizzazione
0 0 Black
0 1 White
1 0 Schermo
1 1 Schermo inverso

Descrizione

nbsp; Windows &NT: richiede 3.1 o versione successiva.
Windows:Richiede Windows 95 o versioni successive.
Windows CE:Non supportato.
Intestazione:Dichiarati in winuser.
Importare librerie:Utilizzare user32.lib.

Vedi anche

Panoramica di icone, funzioni di icona, GetSystemMetrics

Rimedio: Inserire il CD-ROM CD di MSDN Library.

Index