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

Vedi anche

Funzioni bitmap

Panoramica delle bitmap

CreateDIBSection

DeleteObject

SelectObject