CreateDialogParam

De CreateDialogParam functie maakt een niet-modaal dialoogvenster van een dialoogvenster vak sjabloon resource. Voordat het dialoogvenster wordt weergegeven, geeft de functie een toepassing gedefinieerde waarde aan de procedure vak dialoogvenster als de parameter lParam van de het WM_INITDIALOG bericht. Een toepassing kan deze waarde gebruiken om te initialiseren besturingselementen in dialoogvensters.

HWND CreateDialogParam) HINSTANCE  hInstance, / / ingang naar toepassingsexemplaarLPCTSTRlpTemplateName, / / identificeert dialoogvenster vak sjabloonHWNDhWndParent, / / verwerken naar eigenaar vensterDLGPROClpDialogFunc, / / aanwijzer aan dialog box procedureLPARAMdwInitParam / / initialisatie waarde);
 

Parameters

hInstance
Identificeert een exemplaar van de module waarvan het uitvoerbare bestand het dialoogvenster vak sjabloon bevat.
lpTemplateName
Identificeert de dialoogvenster vak sjabloon. Deze parameter is de aanwijzer aan een op null eindigende tekenreeks die de naam aangeeft van het dialoogvenster vak sjabloon of een integer-waarde die de resource-id van het dialoogvenster vak sjabloon aangeeft. Als de parameter een resource-id geeft, de eersterangs woord moet nul zijn en woord van lagere orde moet de identificatie bevatten. U kunt de macro MAKEINTRESOURCE gebruiken om deze waarde te creŽren.
hWndParent
Het venster dat eigenaar is van het dialoogvenster identificeert.
lpDialogFunc
Verwijzing naar het dialoogvenster vak procedure. Zie voor meer informatie over het dialoogvenster vak procedure, DialogProc.
dwInitParam
Geeft de waarde aan doorgeven aan het dialoogvenster vak procedure in de parameter lParam in het WM_INITDIALOG bericht.

Retourwaarden

Als de functie slaagt, is de geretourneerde waarde de vensteringang voor het dialoogvenster.

Als de functie mislukt, is de retourwaarde NULL. Te krijgen uitgebreide foutinformatie, Bel GetLastError.

Opmerkingen

De functie CreateDialogParam wordt de functie CreateWindowEx gebruikt om het dialoogvenster te maken. CreateDialogParam stuurt een WM_INITDIALOG bericht (en een WM_SETFONT-bericht) als de sjabloon de stijl van de DS_SETFONT geeft naar het dialoogvenster vak procedure. De functie wordt het dialoogvenster weergegeven als de sjabloon de WS_VISIBLE stijl geeft. Tot slot, CreateDialogParam retourneert de vensteringang van het dialoogvenster.

Nadat CreateDialogParam terugkeert, de toepassing wordt weergegeven in het dialoogvenster (als het nog niet wordt weergegeven) met behulp van de functie ShowWindow . De toepassing vernietigt het dialoogvenster van de functie DestroyWindow.

Windows 95 en hoger:Het systeem kan maximaal 255 besturingselementen per dialoogvenster vak sjabloon ondersteunen. Meer dan 255 besturingselementen in het dialoogvenster plaatsen, maakt u de besturingselementen in de handler WM_INITDIALOG bericht eerder dan het plaatsen van hen in de sjabloon.

Windows CE: Niet alle opmaakprofielen worden ondersteund in de DLGTEMPLATE structuur in het dialoogvenster sjabloon waarnaar door de parameter lpTemplateName .

Syntaxisinfo

nbsp;†Windows &NT: versie 3.1 of hoger vereist.
Windows:Windows 95 of hoger vereist.
Windows CE:Versie 1.0 of hoger vereist.
Header:Verklaard in winuser.h.
Bibliotheek importeren:User32.lib gebruiken.
Unicode:GeÔmplementeerd als Unicode en ANSI-versies van Windows NT.

Zie ook

Overzicht van dialoogvenster vakken, dialoogvenster vak functies, CreateDialog, CreateDialogIndirect, CreateDialogIndirectParam, CreateWindowEx, DestroyWindow, DialogProc, MAKEINTRESOURCE, ShowWindow, WM_INITDIALOG, WM_SETFONT

Index