GetDialogSize, fonction

[La fonctionnalité associée à cette page, DirectShow, est une fonctionnalité héritée. Il a été remplacé par MediaPlayer, IMFMediaEngine et Audio/Video Capture in Media Foundation. Ces fonctionnalités ont été optimisées pour Windows 10 et Windows 11. Microsoft recommande vivement que le nouveau code utilise MediaPlayer, IMFMediaEngine et Audio/Video Capture dans Media Foundation au lieu de DirectShow, si possible. Microsoft suggère que le code existant qui utilise les API héritées soit réécrit pour utiliser les nouvelles API si possible.]

La fonction GetDialogSize récupère la taille d’une boîte de dialogue de ressource.

Syntaxe

BOOL WINAPI GetDialogSize(
   int     iResourceID,
   DLGPROC pDlgProc,
   LPARAM  lParam,
   SIZE    *pResult
);

Paramètres

iResourceID

Identificateur de ressource de la boîte de dialogue.

pDlgProc

Pointeur vers la procédure de boîte de dialogue.

lParam

Valeur transmise dans le message WM_INITDIALOG envoyé à la boîte de dialogue temporaire juste après sa création.

pResult

Pointeur vers une structure SIZE qui reçoit les dimensions de la boîte de dialogue, en pixels d’écran.

Valeur renvoyée

Retourne TRUE si la ressource de boîte de dialogue a été trouvée, ou FALSE dans le cas contraire.

Notes

Les pages de propriétés peuvent utiliser cette fonction pour retourner la taille d’affichage réelle dont elles ont besoin. La plupart des pages de propriétés sont des boîtes de dialogue et, par conséquent, ont des modèles de boîte de dialogue stockés dans des fichiers de ressources. Les modèles utilisent des unités de boîte de dialogue qui ne sont pas mappées directement sur les pixels de l’écran. Toutefois, la fonction GetPageInfo d’une page de propriétés doit retourner la taille d’affichage réelle en pixels. La page de propriétés peut appeler GetDialogSize pour calculer la taille d’affichage.

Cette fonction crée une instance temporaire de la boîte de dialogue. Pour éviter que la boîte de dialogue s’affiche à l’écran, le modèle de boîte de dialogue dans le fichier de ressources ne doit pas avoir de propriété WS_VISIBLE.

Configuration requise

Voir aussi

Fonctions d’assistance de page de propriétés