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
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte |
Windows 7 [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte |
Windows Server 2008 R2 [somente aplicativos da área de trabalho] |
| Cabeçalho |
|