Message WM_DWMSENDICONICTHUMBNAIL
Indique à une fenêtre de fournir une bitmap statique à utiliser comme représentation miniature de cette fenêtre.
Paramètres
-
wParam
-
Aucun affichage.
-
lParam
-
Le HIWORD de cette valeur est la coordonnée x maximale de la miniature. Le LOWORD est la coordonnée y maximale. Si une miniature a une dimension qui dépasse une ou les deux valeurs, le gestionnaire de fenêtrage n’accepte pas la miniature.
Valeur retournée
Si une application traite ce message, elle doit retourner à zéro.
Notes
Le gestionnaire de fenêtrage envoie ce message à une fenêtre si toutes les situations suivantes sont vraies :
- Le gestionnaire de fenêtrage affiche une représentation sous forme d’icône de la fenêtre.
- L’attribut DWMWA_HAS_ICONIC_BITMAP est défini sur la fenêtre.
- La fenêtre n’a pas défini de bitmap mise en cache.
- Il y a de la place dans le cache pour une autre bitmap.
La fenêtre qui reçoit ce message doit répondre en générant une bitmap dont la taille n’est pas supérieure à la taille demandée dans les paramètres du message. La fenêtre appelle ensuite la fonction DwmSetIconicThumbnail pour remplacer la miniature par défaut. Si la fenêtre ne fournit pas de bitmap dans un certain temps donné, le gestionnaire de fenêtrage utilise sa propre représentation sous forme d’icône par défaut pour la fenêtre.
La fenêtre doit appartenir au processus appelant.
Exemples
L’exemple de code suivant montre comment répondre au message WM_DWMSENDICONICTHUMBNAIL. L’exemple appelle DwmSetIconicThumbnail, avec un handle vers une bitmap personnalisée indépendante de l’appareil à utiliser comme représentation des fenêtres.
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;
Pour obtenir l’exemple complet, consultez l’exemple Personnaliser une miniature sous forme d’icône et une bitmap d’aperçu en direct.
Spécifications
| Condition requise | Value |
|---|---|
| Client minimal pris en charge |
Windows 7 [applications de bureau uniquement] |
| Serveur minimal pris en charge |
Windows Server 2008 R2 [applications de bureau uniquement] |
| En-tête |
|