Mensagem WM_DWMSENDICONICTHUMBNAIL

Instrui uma janela a fornecer um bitmap estático para ser utilizado como uma representação em miniatura dessa janela.

Parâmetros

wParam

Não usado.

lParam

A HIWORD desse valor é a coordenada x máxima da miniatura. A LOWORD é a coordenada y máxima. Se uma miniatura tiver uma dimensão que exceda um ou ambos os valores, o DWM não aceitará a miniatura.

Valor retornado

Se um aplicativo processar essa mensagem, ela deverá retornar zero.

Comentários

O DWM envia essa mensagem para uma janela se todas as situações a seguir forem verdadeiras:

• A DWM está exibindo uma representação icônica da janela.
• O atributo DWMWA_HAS_ICONIC_BITMAP está definido na janela.
• A janela não definiu um bitmap em armazenado em cache.
• Há espaço no cache para outro bitmap.

A janela que recebe essa mensagem deve responder gerando um bitmap que não seja maior do que o tamanho solicitado nos parâmetros da mensagem. Em seguida, a janela chama a função DwmSetIconicThumbnail para substituir a miniatura padrão. Se a janela não fornecer um bitmap em um determinado período, o DWM usará sua própria representação icônica padrão para a janela.

A janela deve pertencer ao processo de chamada.

Exemplos

O exemplo de código a seguir mostra como responder à mensagem WM_DWMSENDICONICTHUMBNAIL. O exemplo chama DwmSetIconicThumbnail, com um identificador para um bitmap personalizado e independente do dispositivo a ser utilizado como representação das janelas.

        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;

Para ver o exemplo completo, confira a amostra Personalizar uma Miniatura Icônica e um Bitmap de Visualização ao vivo.

Requisitos

Confira também

DwmInvalidateIconicBitmaps

WM_DWMSENDICONICLIVEPREVIEWBITMAP