Megosztás a következőn keresztül:

Párbeszédpanelek (párbeszédpanelek)

  • Cikk

A párbeszédpanel egy ideiglenes ablak, amelyet az alkalmazás hoz létre a felhasználói bemenet lekéréséhez. Az alkalmazások általában párbeszédpanelek használatával kérik a felhasználót, hogy további információkat kérjenek a menüelemekről. A párbeszédpanelek általában egy vagy több vezérlőt (gyermekablakot) tartalmaznak, amellyel a felhasználó szöveget ír be, kiválasztja a beállításokat, vagy irányítja a műveletet.

A Windows előre definiált párbeszédpaneleket is biztosít, amelyek támogatják a gyakori menüelemeket, például A megnyitása és Nyomtatás. Az ezeket a menüelemeket használó alkalmazásoknak a gyakori párbeszédpaneleken kell kérniük ezt a felhasználói bemenetet, függetlenül az alkalmazás típusától.

Ebben a szakaszban

Név Leírás
Névjegy párbeszédpanelek Az alkalmazások felhasználói felületén található párbeszédpanelek használatát ismerteti.
párbeszédpanel programozási szempontjai Ez az áttekintés néhány programozási szempontot tárgyal a párbeszédpanelekkel kapcsolatban.
Párbeszédpanelek használata A párbeszédpanelek segítségével megjelenítheti az információkat, és bemenetet kérhet a felhasználótól.
párbeszédpanel hivatkozási Az API-referencia
Gyakori párbeszédpaneltár Az alkalmazások felhasználói felületén található gyakori párbeszédpanelek használatát ismerteti.

Párbeszédpanel-függvények

Név Leírás
CreateDialog Egy mód nélküli párbeszédpanelt hoz létre egy párbeszédpanelsablon-erőforrásból.
CreateDialogIndirect Mód nélküli párbeszédpanelt hoz létre egy párbeszédpanelsablonból a memóriában.
CreateDialogIndirectParam Mód nélküli párbeszédpanelt hoz létre egy párbeszédpanelsablonból a memóriában. A párbeszédpanel megjelenítése előtt a függvény egy alkalmazás által definiált értéket ad át a párbeszédpanel-eljárásnak a WM_INITDIALOG üzenet lParam paramétereként. Az alkalmazások ezt az értéket használhatják a párbeszédpanel-vezérlők inicializálására.
CreateDialogParam Egy mód nélküli párbeszédpanelt hoz létre egy párbeszédpanelsablon-erőforrásból. A párbeszédpanel megjelenítése előtt a függvény egy alkalmazás által definiált értéket ad át a párbeszédpanel-eljárásnak a WM_INITDIALOG üzenet lParam paramétereként. Az alkalmazások ezt az értéket használhatják a párbeszédpanel-vezérlők inicializálására.
DefDlgProc Meghívja az alapértelmezett párbeszédpanel-ablak eljárást, amely alapértelmezett feldolgozást biztosít minden olyan ablaküzenethez, amelyet egy privát ablakosztályt tartalmazó párbeszédpanel nem dolgoz fel.
Párbeszédpanel Létrehoz egy modális párbeszédpanelt egy párbeszédpanelsablon-erőforrásból. DialogBox csak akkor adja vissza a vezérlőt, ha a megadott visszahívási függvény a EndDialog függvény meghívásával leállítja a modális párbeszédpanelt.
DialogBoxIndirect Modális párbeszédpanelt hoz létre egy párbeszédpanelsablonból a memóriában. DialogBoxIndirect csak akkor adja vissza a vezérlőt, ha a megadott visszahívási függvény a EndDialog függvény meghívásával leállítja a modális párbeszédpanelt.
DialogBoxIndirectParam Modális párbeszédpanelt hoz létre egy párbeszédpanelsablonból a memóriában. A párbeszédpanel megjelenítése előtt a függvény egy alkalmazás által definiált értéket ad át a párbeszédpanel-eljárásnak a WM_INITDIALOG üzenet lParam paramétereként. Az alkalmazások ezt az értéket használhatják a párbeszédpanel-vezérlők inicializálására.
DialogBoxParam Létrehoz egy modális párbeszédpanelt egy párbeszédpanelsablon-erőforrásból. A párbeszédpanel megjelenítése előtt a függvény egy alkalmazás által definiált értéket ad át a párbeszédpanel-eljárásnak a WM_INITDIALOG üzenet lParam paramétereként. Az alkalmazások ezt az értéket használhatják a párbeszédpanel-vezérlők inicializálására.
DialogProc Egy alkalmazás által definiált visszahívási függvény, amelyet a CreateDialog és DialogBox függvénycsaládokkal használnak. Modális vagy mód nélküli párbeszédpanelre küldött üzeneteket dolgoz fel. A DLGPROC típus a visszahívási függvény mutatóját határozza meg. DialogProc az alkalmazás által definiált függvénynév helyőrzője.
EndDialog Elpusztít egy modális párbeszédpanelt, ami miatt a rendszer befejezi a párbeszédpanel feldolgozását.
GetDialogBaseUnits Lekéri a rendszer párbeszédpanel-alapegységeit, amelyek a rendszer betűtípusában szereplő karakterek átlagos szélességét és magasságát tartalmazzák. A rendszer betűtípusát használó párbeszédpanelek esetében ezeket az értékeket használhatja a párbeszédpanelsablonok egységei és képpontjai közötti konvertáláshoz. A rendszer betűtípusát nem használó párbeszédpanelek esetében a párbeszédpanel-sablonegységek képpontokra konvertálása a párbeszédpanel által használt betűtípustól függ.
GetDlgCtrlID Lekéri a megadott vezérlő azonosítóját.
GetDlgItem Lekéri a fogópontot a megadott párbeszédpanel vezérlőihez.
GetDlgItemInt Egy párbeszédpanel adott vezérlőelemének szövegét lefordítja egész szám értékre.
GetDlgItemText Beolvassa egy vezérlőelemhez tartozó címet vagy szöveget egy párbeszédpanelen.
GetNextDlgGroupItem Lekéri a fogópontot az első vezérlőhöz egy olyan vezérlőcsoportban, amely megelőzi (vagy követi) a megadott vezérlőt egy párbeszédpanelen.
GetNextDlgTabItem Lekéri a leírót az első vezérlőhöz, amely a megadott vezérlőelemet megelőző (vagy azt követő) WS_TABSTOP stílussal rendelkezik.
IsDialogMessage Meghatározza, hogy egy üzenet a megadott párbeszédpanelre van-e szánva, és ha igen, feldolgozza az üzenetet.
MapDialogRect A megadott párbeszédpanel-egységeket képernyőegységekké (képpontokká) alakítja. A függvény lecseréli a megadott RECT szerkezet koordinátáit a konvertált koordinátákra, így a struktúra párbeszédpanel létrehozásához vagy vezérlőelemek párbeszédpanelen belüli elhelyezéséhez használható.
MessageBox Egy modális párbeszédpanelt jelenít meg, amely tartalmaz egy rendszerikont, egy gombkészletet és egy rövid alkalmazásspecifikus üzenetet, például állapot- vagy hibainformációt. Az üzenetmező egy egész számot ad vissza, amely jelzi, hogy a felhasználó melyik gombra kattintott.
MessageBoxEx Üzenetmezőt hoz létre, jelenít meg és üzemeltet. Az üzenetmező alkalmazás által definiált üzenetet és címet, valamint előre definiált ikonokat és leküldéses gombokat tartalmaz. A gombok a rendszer felhasználói felületének nyelvén találhatók.
MessageBoxIndirect Üzenetmezőt hoz létre, jelenít meg és üzemeltet. Az üzenetmező alkalmazás által definiált üzenetszöveget és címet, bármilyen ikont és előre definiált leküldéses gombokat tartalmaz.
SendDlgItemMessage Üzenet küldése a megadott vezérlőnek egy párbeszédpanelen.
SetDlgItemInt Egy párbeszédpanel vezérlőelemének szövegét egy megadott egész szám értékének sztring-ábrázolására állítja be.
SetDlgItemText Egy vezérlőelem címét vagy szövegét állítja be egy párbeszédpanelen.

Párbeszédpanel-üzenetek

Név Leírás
DM_GETDEFID Lekéri egy párbeszédpanel alapértelmezett leküldéses gomb vezérlőelemének azonosítóját.
DM_REPOSITION Áthelyez egy legfelső szintű párbeszédpanelt, hogy elférjen az asztal területén. Az alkalmazás átméretezése után elküldheti ezt az üzenetet egy párbeszédpanelnek, hogy a teljes párbeszédpanel látható maradjon.
DM_SETDEFID Módosítja egy párbeszédpanel alapértelmezett leküldéses gombjának azonosítóját.

Párbeszédpaneles értesítések

Név Leírás
WM_CTLCOLORDLG Elküldve egy párbeszédpanelre, mielőtt a rendszer megrajzolja a párbeszédpanelt. Az üzenet megválaszolásával a párbeszédpanel a megadott megjelenítési eszköz környezeti leírójával beállíthatja a szövegét és a háttérszíneit.
WM_ENTERIDLE Egy inaktív állapotot beíró modális párbeszédpanel vagy menü tulajdonosablakába küldve. A modális párbeszédpanelek vagy menük tétlen állapotba kerülnek, ha egy vagy több korábbi üzenet feldolgozása után egyetlen üzenet sem várakozik az üzenetsorában.
WM_GETDLGCODE Elküldve a vezérlőelemhez társított ablakművelethez. Alapértelmezés szerint a rendszer kezeli a vezérlő összes billentyűzetbemenetét; a rendszer bizonyos típusú billentyűzetbemeneteket párbeszédpaneles navigációs kulcsokként értelmez. Az alapértelmezett viselkedés felülbírálásához a vezérlő válaszolhat a WM_GETDLGCODE üzenetre, hogy jelezze, milyen típusú bemenetet szeretne feldolgozni.
WM_INITDIALOG Közvetlenül a párbeszédpanel megjelenése előtt elküldve a párbeszédpanel eljárásának. A párbeszédpanel-eljárások általában ezt az üzenetet használják vezérlők inicializálására és a párbeszédpanel megjelenését befolyásoló egyéb inicializálási feladatok végrehajtására.
WM_NEXTDLGCTL A párbeszédpanelen egy másik vezérlőre történő billentyűzetfókusz beállításához küldve a párbeszédpanelen.

Párbeszédpanel-struktúrák

Név Leírás
DLGITEMTEMPLATE Egy vezérlőelem dimenzióit és stílusát határozza meg egy párbeszédpanelen. Egy vagy több ilyen struktúrát egy DLGTEMPLATE struktúrával kombinálunk, hogy szabványos sablont alakítsunk ki egy párbeszédpanelhez.
DLGITEMTEMPLATEEX Egy bővített párbeszédpanelt ismertet. A kiterjesztett párbeszédpanel-sablon formátumának leírását a DLGTEMPLATEEXcímű témakörben talál.
DLGTEMPLATE Egy párbeszédpanel dimenzióit és stílusát határozza meg. Ez a struktúra, amely mindig az első egy párbeszédpanel szabványos sablonjában, a párbeszédpanel vezérlőinek számát is meghatározza, ezért megadja a sablon későbbi DLGITEMTEMPLATE struktúráinak számát.
DLGTEMPLATEEX A kiterjesztett párbeszédpanel-sablon egy DLGTEMPLATEEX fejléccel kezdődik, amely leírja a párbeszédpanelt, és megadja a párbeszédpanel vezérlőinek számát. A párbeszédpanel minden vezérlőjéhez egy bővített párbeszédpanelsablon olyan adatblokkot biztosít, amely a DLGITEMTEMPLATEEX formátumot használja a vezérlő leírásához.
MSGBOXPARAMS Az üzenetmező megjelenítéséhez használt információkat tartalmazza. A MessageBoxIndirect függvény ezt a struktúrát használja.