messaggio WM_DWMedizione Standard NDICONICTHUMBNAIL

Indica a una finestra di fornire una bitmap statica da utilizzare come rappresentazione di anteprima di tale finestra.

Parametri

wParam

Non utilizzato.

lParam

L'HIWORD di questo valore è la coordinata x massima dell'anteprima. LOWORD è la coordinata y massima. Se un'anteprima ha una dimensione che supera uno o entrambi questi valori, DWM non accetta l'anteprima.

Valore restituito

Se un'applicazione elabora questo messaggio, deve restituire zero.

Osservazioni:

DWM invia questo messaggio a una finestra se tutte le situazioni seguenti sono vere:

• DWM visualizza una rappresentazione iconica della finestra.
• L'attributo DWMWA_HAS_ICONIC_BITMAP è impostato nella finestra.
• La finestra non ha impostato una bitmap memorizzata nella cache.
• C'è spazio nella cache per un'altra bitmap.

La finestra che riceve questo messaggio deve rispondere generando una bitmap non maggiore delle dimensioni richieste nei parametri del messaggio. La finestra chiama quindi la funzione DwmSetIconicThumbnail per eseguire l'override dell'anteprima predefinita. Se la finestra non fornisce una bitmap in un determinato periodo di tempo, DWM usa la propria rappresentazione iconica predefinita per la finestra.

La finestra deve appartenere al processo chiamante.

Esempi

Nell'esempio di codice seguente viene illustrato come rispondere al messaggio WM_DWMedizione Standard NDICONICTHUMBNAIL. L'esempio chiama DwmSetIconicThumbnail, con un handle per una bitmap personalizzata indipendente dal dispositivo da usare come rappresentazione delle finestre.

        case WM_DWMSENDICONICTHUMBNAIL:
        {    
            // This window is being asked to provide its iconic bitmap. This indicates
            // a thumbnail is being drawn.
            hbm = CreateDIB(HIWORD(lParam), LOWORD(lParam)); 
            if (hbm)
            {
                hr = DwmSetIconicThumbnail(hwnd, hbm, 0);
                DeleteObject(hbm);
            }
        }
        break;

Per l'esempio completo, vedi l'esempio Personalizzare un'anteprima iconica e un'anteprima in tempo reale bitmap .

Requisiti

Requisito	Valore
Client minimo supportato	Windows 7 [solo app desktop]
Server minimo supportato	Windows Server 2008 R2 [solo app desktop]
Intestazione	Dwmapi.h

Vedi anche

DwmInvalidateIconicBitmaps

WM_DWMedizione Standard NDICONICLIVEPREVIEWBITMAP