GetDialogSize-Funktion
[Das dieser Seite zugeordnete Feature DirectShow ist ein Legacyfeature. Es wurde durch MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation ersetzt. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code nach Möglichkeit MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation anstelle von DirectShow verwendet. Microsoft schlägt vor, vorhandenen Code, der die Legacy-APIs verwendet, um nach Möglichkeit die neuen APIs zu verwenden.]
Die GetDialogSize-Funktion ruft die Größe eines Ressourcendialogfelds ab.
Syntax
BOOL WINAPI GetDialogSize(
int iResourceID,
DLGPROC pDlgProc,
LPARAM lParam,
SIZE *pResult
);
Parameter
-
iResourceID
-
Ressourcenbezeichner des Dialogfelds.
-
pDlgProc
-
Zeiger auf die Dialogfeldprozedur.
-
lParam
-
Wert, der in der WM_INITDIALOG Nachricht übergeben wird, die direkt nach der Erstellung an das temporäre Dialogfeld gesendet wurde.
-
pResult
-
Zeiger auf eine SIZE-Struktur , die die Dimensionen des Dialogfelds in Bildschirmpixeln empfängt.
Rückgabewert
Gibt TRUE zurück, wenn die Dialogfeldressource gefunden wurde, oder andernfalls FALSE .
Bemerkungen
Eigenschaftenseiten können diese Funktion verwenden, um die tatsächliche Anzeigegröße zurückzugeben, die sie benötigen. Bei den meisten Eigenschaftenseiten handelt es sich um Dialogfelder, die in Ressourcendateien gespeichert sind. Vorlagen verwenden Dialogfeldeinheiten, die nicht direkt den Bildschirmpixeln zugeordnet werden. Die GetPageInfo-Funktion einer Eigenschaftenseite muss jedoch die tatsächliche Anzeigegröße in Pixel zurückgeben. Die Eigenschaftenseite kann aufrufen GetDialogSize , um die Anzeigegröße zu berechnen.
Diese Funktion erstellt eine temporäre instance des Dialogfelds. Damit das Dialogfeld nicht auf dem Bildschirm angezeigt wird, sollte die Dialogfeldvorlage in der Ressourcendatei keine WS_VISIBLE-Eigenschaft aufweisen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header |
|
| Bibliothek |
|