Funzione CreateCompatibleBitmap (wingdi.h)
La funzione CreateCompatibleBitmap crea una bitmap compatibile con il dispositivo associato al contesto del dispositivo specificato.
Sintassi
HBITMAP CreateCompatibleBitmap(
[in] HDC hdc,
[in] int cx,
[in] int cy
);
Parametri
[in] hdc
Handle per un contesto di dispositivo.
[in] cx
Larghezza bitmap, in pixel.
[in] cy
Altezza bitmap, in pixel.
Valore restituito
Se la funzione ha esito positivo, il valore restituito è un handle per la bitmap compatibile (DDB).
Se la funzione ha esito negativo, il valore restituito è NULL.
Commenti
Il formato del colore della bitmap creato dalla funzione CreateCompatibleBitmap corrisponde al formato di colore del dispositivo identificato dal parametro hdc . Questa bitmap può essere selezionata in qualsiasi contesto di dispositivo di memoria compatibile con il dispositivo originale.
Poiché i contesti dei dispositivi di memoria consentono sia bitmap di colore che monocromatiche, il formato della bitmap restituita dalla funzione CreateCompatibleBitmap differisce quando il contesto del dispositivo specificato è un contesto del dispositivo di memoria. Tuttavia, una bitmap compatibile creata per un contesto di dispositivo nonmemory possiede sempre lo stesso formato di colore e usa la stessa tavolozza colori del contesto del dispositivo specificato.
Nota: quando viene creato un contesto di dispositivo di memoria, inizialmente ha una bitmap monocromatica 1 per 1 selezionata. Se questo contesto del dispositivo di memoria viene usato in CreateCompatibleBitmap, la bitmap creata è una bitmap monocromatica . Per creare una bitmap di colore, usare HDC usato per creare il contesto del dispositivo di memoria, come illustrato nel codice seguente:
HDC memDC = CreateCompatibleDC ( hDC );
HBITMAP memBM = CreateCompatibleBitmap ( hDC, nWidth, nHeight );
SelectObject ( memDC, memBM );
Se un'applicazione imposta i parametri nWidth o nHeight su zero, CreateCompatibleBitmap restituisce l'handle su un bitmap monocromatico 1 by-1.
Se una sezione DIB, che è una bitmap creata dalla funzione CreateDIBSection , viene selezionata nel contesto del dispositivo identificato dal parametro hdc , CreateCompatibleBitmap crea una sezione DIB.
Quando non è più necessaria la bitmap, chiamare la funzione DeleteObject per eliminarla.
Esempio
Per un esempio, vedere Ridimensionamento di un'immagine.
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 | wingdi.h (include Windows.h) |
| Libreria | Gdi32.lib |
| DLL | Gdi32.dll |