Delen via

Dialoogvensters (dialoogvensters)

  • Artikel

Een dialoogvenster is een tijdelijk venster dat een toepassing maakt om gebruikersinvoer op te halen. Een toepassing gebruikt doorgaans dialoogvensters om de gebruiker te vragen om aanvullende informatie voor menu-items. Een dialoogvenster bevat meestal een of meer besturingselementen (onderliggende vensters) waarmee de gebruiker tekst invoert, opties kiest of de actie omstuurt.

Windows biedt ook vooraf gedefinieerde dialoogvensters die algemene menu-items ondersteunen, zoals openen en Afdrukken. Toepassingen die deze menu-items gebruiken, moeten de algemene dialoogvensters gebruiken om te vragen om deze gebruikersinvoer, ongeacht het type toepassing.

In deze sectie

Naam Beschrijving
dialoogvensters Hiermee wordt het gebruik van dialoogvensters in de gebruikersinterface voor uw toepassingen besproken.
overwegingen voor programmeren in dialoogvensters In dit overzicht worden enkele programmeeroverwegingen met betrekking tot dialoogvensters besproken.
Dialoogvensters gebruiken U gebruikt dialoogvensters om informatie weer te geven en om invoer van de gebruiker te vragen.
in het dialoogvenster De API-verwijzing
Algemene dialoogvensterbibliotheek Hiermee wordt het gebruik van de algemene dialoogvensters in de gebruikersinterface voor uw toepassingen besproken.

Dialoogvensterfuncties

Naam Beschrijving
CreateDialog- Hiermee maakt u een modusloos dialoogvenster op basis van een resource voor een dialoogvenstersjabloon.
CreateDialogIndirect- Hiermee maakt u een modusloos dialoogvenster op basis van een dialoogvenstersjabloon in het geheugen.
CreateDialogIndirectParam- Hiermee maakt u een modusloos dialoogvenster op basis van een dialoogvenstersjabloon in het geheugen. Voordat het dialoogvenster wordt weergegeven, geeft de functie een door de toepassing gedefinieerde waarde door aan de procedure van het dialoogvenster als de parameter lParam van het WM_INITDIALOG bericht. Een toepassing kan deze waarde gebruiken om besturingselementen voor dialoogvensters te initialiseren.
CreateDialogParam- Hiermee maakt u een modusloos dialoogvenster op basis van een resource voor een dialoogvenstersjabloon. Voordat het dialoogvenster wordt weergegeven, geeft de functie een door de toepassing gedefinieerde waarde door aan de procedure van het dialoogvenster als de parameter lParam van het WM_INITDIALOG bericht. Een toepassing kan deze waarde gebruiken om besturingselementen voor dialoogvensters te initialiseren.
DefDlgProc- Roept de standaardvensterprocedure voor dialoogvensters aan om standaardverwerking te bieden voor vensterberichten die een dialoogvenster met een privévensterklasse niet verwerkt.
dialoogvenster Hiermee maakt u een modaal dialoogvenster op basis van een resource voor een dialoogvenstersjabloon. Dialoogvenster retourneert geen besturingselement totdat de opgegeven callback-functie het modale dialoogvenster beëindigt door de enddialog- functie aan te roepen.
DialogBoxIndirect- Hiermee maakt u een modaal dialoogvenster op basis van een dialoogvenstersjabloon in het geheugen. DialogBoxIndirect retourneert geen besturingselement totdat de opgegeven callback-functie het modale dialoogvenster beëindigt door de EndDialog--functie aan te roepen.
DialogBoxIndirectParam- Hiermee maakt u een modaal dialoogvenster op basis van een dialoogvenstersjabloon in het geheugen. Voordat het dialoogvenster wordt weergegeven, geeft de functie een door de toepassing gedefinieerde waarde door aan de procedure van het dialoogvenster als de parameter lParam van het WM_INITDIALOG bericht. Een toepassing kan deze waarde gebruiken om besturingselementen voor dialoogvensters te initialiseren.
DialoogvensterParam Hiermee maakt u een modaal dialoogvenster op basis van een resource voor een dialoogvenstersjabloon. Voordat het dialoogvenster wordt weergegeven, geeft de functie een door de toepassing gedefinieerde waarde door aan de procedure van het dialoogvenster als de parameter lParam van het WM_INITDIALOG bericht. Een toepassing kan deze waarde gebruiken om besturingselementen voor dialoogvensters te initialiseren.
DialogProc- Een door de toepassing gedefinieerde callback-functie die wordt gebruikt met de CreateDialog- en dialoogvenster functiesfamilies. Berichten die naar een modaal of modusloos dialoogvenster worden verzonden, worden verwerkt. Het DLGPROC- type definieert een aanwijzer naar deze callback-functie. DialogProc- is een tijdelijke aanduiding voor de naam van de door de toepassing gedefinieerde functie.
EndDialog- Hiermee wordt een modaal dialoogvenster vernietigd, waardoor het systeem de verwerking voor het dialoogvenster beëindigt.
GetDialogBaseUnits Hiermee worden de dialoogvensterbasiseenheden van het systeem opgehaald. Dit zijn de gemiddelde breedte en hoogte van tekens in het lettertype van het systeem. Voor dialoogvensters die het systeemlettertype gebruiken, kunt u deze waarden gebruiken om te converteren tussen dialoogvenstersjablooneenheden, zoals opgegeven in dialoogvenstersjablonen en pixels. Voor dialoogvensters die het systeemlettertype niet gebruiken, is de conversie van dialoogvenstersjablooneenheden naar pixels afhankelijk van het lettertype dat door het dialoogvenster wordt gebruikt.
GetDlgCtrlID- Haalt de id van het opgegeven besturingselement op.
GetDlgItem- Hiermee wordt een ingang opgehaald naar een besturingselement in het opgegeven dialoogvenster.
GetDlgItemInt- Hiermee wordt de tekst van een opgegeven besturingselement in een dialoogvenster omgezet in een geheel getal.
GetDlgItemText- Hiermee haalt u de titel of tekst op die is gekoppeld aan een besturingselement in een dialoogvenster.
GetNextDlgGroupItem- Hiermee wordt een ingang opgehaald naar het eerste besturingselement in een groep besturingselementen die voorafgaat aan (of volgt) het opgegeven besturingselement in een dialoogvenster.
GetNextDlgTabItem- Hiermee wordt een ingang opgehaald naar het eerste besturingselement met de WS_TABSTOP stijl die voorafgaat aan het opgegeven besturingselement (of volgt).
IsDialogMessage Hiermee bepaalt u of een bericht is bedoeld voor het opgegeven dialoogvenster en, indien van toepassing, het bericht verwerkt.
MapDialogRect- Converteert de opgegeven dialoogvenstereenheden naar schermeenheden (pixels). De functie vervangt de coördinaten in de opgegeven RECT- structuur door de geconverteerde coördinaten, waardoor de structuur kan worden gebruikt om een dialoogvenster te maken of een besturingselement in een dialoogvenster te plaatsen.
MessageBox- Geeft een modaal dialoogvenster weer dat een systeempictogram, een set knoppen en een kort toepassingsspecifiek bericht bevat, zoals status- of foutinformatie. Het berichtvak retourneert een geheel getal dat aangeeft op welke knop de gebruiker heeft geklikt.
MessageBoxEx- Hiermee wordt een berichtvak gemaakt, weergegeven en uitgevoerd. Het berichtvak bevat een toepassingsgedefinieerd bericht en een titel, plus een combinatie van vooraf gedefinieerde pictogrammen en drukknoppen. De knoppen bevinden zich in de taal van de gebruikersinterface van het systeem.
MessageBoxIndirect- Hiermee wordt een berichtvak gemaakt, weergegeven en uitgevoerd. Het berichtvak bevat toepassingsgedefinieerde berichttekst en titel, elk pictogram en een combinatie van vooraf gedefinieerde drukknoppen.
SendDlgItemMessage- Hiermee wordt een bericht verzonden naar het opgegeven besturingselement in een dialoogvenster.
SetDlgItemInt- Hiermee stelt u de tekst van een besturingselement in een dialoogvenster in op de tekenreeksweergave van een opgegeven geheel getal.
SetDlgItemText- Hiermee stelt u de titel of tekst van een besturingselement in een dialoogvenster in.

Berichten in dialoogvenster

Naam Beschrijving
DM_GETDEFID Hiermee haalt u de id van het standaardknop besturingselement voor een dialoogvenster op.
DM_REPOSITION Hiermee verplaatst u een dialoogvenster op het hoogste niveau zodat het binnen het bureaubladgebied past. Een toepassing kan dit bericht verzenden naar een dialoogvenster nadat het formaat ervan is gewijzigd om ervoor te zorgen dat het hele dialoogvenster zichtbaar blijft.
DM_SETDEFID Hiermee wijzigt u de id van de standaardknop voor een dialoogvenster.

Meldingen in het dialoogvenster

Naam Beschrijving
WM_CTLCOLORDLG Verzonden naar een dialoogvenster voordat het systeem het dialoogvenster tekent. Als u op dit bericht reageert, kan het dialoogvenster de tekst- en achtergrondkleuren instellen met behulp van de opgegeven contextgreep van het weergaveapparaat.
WM_ENTERIDLE Verzonden naar het eigenaarsvenster van een modaal dialoogvenster of menu dat een niet-actieve status invoert. Een modaal dialoogvenster of menu voert een niet-actieve status in wanneer er geen berichten in de wachtrij staan nadat een of meer eerdere berichten zijn verwerkt.
WM_GETDLGCODE Verzonden naar de vensterprocedure die is gekoppeld aan een besturingselement. Standaard verwerkt het systeem alle toetsenbordinvoer voor het besturingselement; het systeem interpreteert bepaalde typen toetsenbordinvoer als navigatietoetsen in het dialoogvenster. Als u dit standaardgedrag wilt overschrijven, kan het besturingselement reageren op het WM_GETDLGCODE bericht om aan te geven welke typen invoer het zelf wil verwerken.
WM_INITDIALOG Verzonden naar de dialoogvensterprocedure direct voordat een dialoogvenster wordt weergegeven. In dialoogvensterprocedures wordt dit bericht doorgaans gebruikt om besturingselementen te initialiseren en andere initialisatietaken uit te voeren die van invloed zijn op het uiterlijk van het dialoogvenster.
WM_NEXTDLGCTL Verzonden naar een dialoogvensterprocedure om de toetsenbordfocus in te stellen op een ander besturingselement in het dialoogvenster.

Dialoogvensterstructuren

Naam Beschrijving
DLGITEMTEMPLATE- Definieert de dimensies en stijl van een besturingselement in een dialoogvenster. Een of meer van deze structuren worden gecombineerd met een DLGTEMPLATE structuur om een standaardsjabloon voor een dialoogvenster te vormen.
DLGITEMPLATEEX- Beschrijft een uitgebreid dialoogvenster. Zie DLGTEMPLATEEXvoor een beschrijving van de indeling van een uitgebreide dialoogvenstersjabloon.
DLGTEMPLATE- Hiermee definieert u de dimensies en stijl van een dialoogvenster. Deze structuur, altijd de eerste in een standaardsjabloon voor een dialoogvenster, geeft ook het aantal besturingselementen in het dialoogvenster op en geeft daarom het aantal volgende DLGITEMTEMPLATE structuren in de sjabloon op.
DLGTEMPLATEEX- Een uitgebreide dialoogvenstersjabloon begint met een DLGTEMPLATEEX koptekst die het dialoogvenster beschrijft en het aantal besturingselementen in het dialoogvenster aangeeft. Voor elk besturingselement in een dialoogvenster heeft een uitgebreide dialoogvenstersjabloon een gegevensblok dat gebruikmaakt van de DLGITEMTEMPLATEEX-indeling indeling om het besturingselement te beschrijven.
MSGBOXPARAMS- Bevat informatie die wordt gebruikt om een berichtvak weer te geven. De functie MessageBoxIndirect maakt gebruik van deze structuur.