Gyakori párbeszédpaneltár
A Közös párbeszédpaneltár párbeszédpaneleket tartalmaz a gyakori alkalmazásfeladatok végrehajtásához, például fájlok megnyitásához, színértékek kiválasztásához és dokumentumok nyomtatásához. A gyakori párbeszédpanelek lehetővé teszik az alkalmazás felhasználói felületének konzisztens megközelítését. Ez csökkenti azt az erőfeszítést, amelyet a felhasználók az alkalmazás felhasználói felületének viselkedésének tanulására költenek.
Ez a szakasz azokat a gyakori párbeszédpaneleket ismerteti, amelyek tartalmazzák a megnyitása és Mentés másként párbeszédpanelt; a keresése és Csere szerkesztés párbeszédpanelen; a Nyomtatási, Nyomtatási beállítás, Tulajdonságlap nyomtatásaés Lapbeállítás nyomtatási párbeszédpanelek; Szín és Betűtípus párbeszédpanelen.
Jegyzet
A Windows Vista-tól kezdve a Open és Save As common dialog boxokat felváltotta a Közös elem párbeszédpanel. Azt javasoljuk, hogy a Common Item Dialog API-t használja a Közös párbeszédpaneltárban található párbeszédpanelek helyett.
Ebben a szakaszban
| Név | Leírás |
|---|---|
| gyakori párbeszédpaneltípusok | A különböző párbeszédpaneleket ismerteti. |
| párbeszédpanel inicializálási jelzőinek | Ismerteti, hogyan használják a jelölőket egy közös párbeszédpanel viselkedésének és megjelenésének módosítására. |
| Gyakori párbeszédpanelek testreszabása | A gyakori párbeszédpanelek használatát ismerteti. |
| Gyakori párbeszédpanelek használata | A gyakori párbeszédpaneleket meghívó feladatokat ismerteti. |
| gyakori párbeszédpanel-referencia | Az API-referenciát tartalmazza. |
Funkciók
| Név | Leírás |
|---|---|
| CCHookProc | Üzeneteket vagy értesítéseket fogad a Szín párbeszédpanel alapértelmezett párbeszédpanel-eljárásához. Ez egy alkalmazás által definiált vagy kódtár által definiált visszahívási függvény, amelyet a ChooseColor függvénnyel használnak. |
| CFHookProc | Üzeneteket vagy értesítéseket fogad a Betűtípus párbeszédpanel alapértelmezett párbeszédpanel-eljárásához. Ez egy alkalmazás által definiált vagy kódtár által definiált visszahívási eljárás, amelyet a ChooseFont függvény használ. |
| ChooseColor | Létrehoz egy Szín párbeszédpanelt, amely lehetővé teszi a felhasználó számára a szín kiválasztását. |
| ChooseFont | Létrehoz egy Betűtípus párbeszédpanelt, amely lehetővé teszi a felhasználó számára a logikai betűtípus attribútumainak kiválasztását. Ezek az attribútumok magukban foglalják a betűtípuscsaládot és a hozzá tartozó betűstílust, a pontméretet, az effektusokat (aláhúzást, kihúzást és szövegszínt), valamint egy szkriptet (vagy karakterkészletet). |
| CommDlgExtendedError | Egy gyakori párbeszédpanel-hibakódot ad vissza. Ez a kód az egyik gyakori párbeszédpanel-függvény végrehajtása során előforduló legutóbbi hibát jelzi. |
| Szövegkereső | Létrehoz egy rendszer által definiált mód nélküli keresése párbeszédpanelt, amely lehetővé teszi, hogy a felhasználó meghatározhassa a keresett sztringet és a dokumentum szövegének keresésekor használni kívánt beállításokat. |
| FRHookProc | Üzeneteket vagy értesítéseket fogad a keresése vagy Csere párbeszédpanel alapértelmezett párbeszédpanel-eljárásához. Ez egy alkalmazás által definiált vagy kódtár által definiált visszahívási függvény, amelyet a Szövegkereső vagy Csereszöveg függvénnyel használnak. |
| GetFileTitle | Lekéri a megadott fájl nevét. |
| GetOpenFileName | Létrehoz egy Megnyitás párbeszédpanelt, amellyel a felhasználó megadhatja a megnyitni kívánt fájl vagy fájlkészlet meghajtóját, könyvtárát és nevét. |
| GetSaveFileName | Létrehoz egy Mentés párbeszédpanelt, amellyel a felhasználó megadhatja a menteni kívánt fájl meghajtóját, könyvtárát és nevét. |
| OFNHookProc | Fogadja a párbeszédpanelről küldött értesítési üzeneteket. A függvény üzeneteket is fogad a gyermek párbeszédpanelsablon megadásával definiált további vezérlőkhöz. Ez egy alkalmazás által definiált vagy kódtár által definiált visszahívási függvény, amely az Explorer-stílusú megnyitása és Mentés másként párbeszédpanelen használható. |
| OFNHookProcOldStyle | A párbeszédpanel-eljáráshoz szánt üzeneteket vagy értesítéseket fogad. Ez egy alkalmazás által definiált vagy kódtár által definiált visszahívási függvény, amely a megnyitása és Mentés másként párbeszédpanelen használható. |
| PagePaintHook | Olyan üzeneteket fogad, amelyek lehetővé teszik a mintalap rajzának testreszabását a Oldalbeállítás párbeszédpanelen. Ez egy alkalmazás által definiált vagy kódtár által definiált visszahívási függvény, amelyet a PageSetupDlg függvénnyel használnak. |
| PageSetupDlg | Létrehoz egy lapbeállítási párbeszédpanelt, amely lehetővé teszi a felhasználó számára a nyomtatott lap attribútumainak megadását. Ezek az attribútumok közé tartozik a papírméret és a forrás, az oldal tájolása (álló vagy fekvő), valamint az oldalmargók szélessége. |
| PageSetupHook | Üzeneteket vagy értesítéseket fogad az Lapbeállítás párbeszédpanel alapértelmezett párbeszédpanel-eljárásához. Ez egy alkalmazás által definiált vagy kódtár által definiált visszahívási függvény, amelyet aPageSetupDlgfüggvénnyel használnak. |
| PrintDlg | Megjeleníti a Nyomtatás párbeszédpanel. A Nyomtatás párbeszédpanelen a felhasználó megadhatja egy adott nyomtatási feladat tulajdonságait. |
| PrintDlgEx | Megjelenít egy Nyomtatási tulajdonságlapot, amely lehetővé teszi a felhasználó számára egy adott nyomtatási feladat tulajdonságainak megadását. ANyomtatásitulajdonságlapon Általános lap található, amely a Nyomtatás párbeszédpanelhez hasonló vezérlőket tartalmaz. A tulajdonságlap további alkalmazásspecifikus és illesztőprogram-specifikus tulajdonságlapokkal, valamint Általános oldallal is rendelkezhet. |
| PrintHookProc | Üzeneteket vagy értesítéseket fogad a Nyomtatás párbeszédpanel alapértelmezett párbeszédpanel-eljárásához. Ez egy alkalmazás által definiált vagy kódtár által definiált visszahívási függvény, amelyet a PrintDlg függvénnyel használnak. |
| Csereszöveg | Létrehoz egy rendszer által definiált mód nélküli párbeszédpanelt, amellyel a felhasználó megadhat egy keresendő sztringet és egy helyettesítő sztringet, valamint szabályozhatja a keresési és csereműveleteket. |
| SetupHookProc | A PrintDlg függvényhez használt alkalmazás- vagy kódtár által definiált visszahívási függvény. A horog eljárás üzeneteket vagy értesítéseket fogad a Nyomtatási beállítás párbeszédpanel alapértelmezett párbeszédpanel-eljárásához. |
Felületek
| Név | Leírás |
|---|---|
| IPrintDialogCallback | Olyan módszereket biztosít, amelyekkel egy alkalmazás értesítéseket és üzeneteket fogadhat a PrintDlgEx függvénytől, miközben megjelenik a Nyomtatási tulajdonságlap. |
| IPrintDialogServices | Olyan módszereket biztosít, amelyek lehetővé teszik, hogy egy alkalmazás a PrintDlgEx függvénnyel adatokat kérjen le az aktuálisan kiválasztott nyomtatóról. |
Üzenetek
| Név | Leírás |
|---|---|
| CDM_GETFILEPATH | Lekéri a kijelölt fájl elérési útját és fájlnevét egy Explorer-stílusú megnyitása vagy Mentés másként párbeszédpanelen. A párbeszédpanelt a OFN_EXPLORER jelzővel kell létrehozni; ellenkező esetben az üzenet meghiúsul. |
| CDM_GETFOLDERIDLIST | Lekéri annak a mappának megfelelő elemazonosító-lista címét, amelyet egy Explorer-stílusú megnyitása vagy Mentés másként párbeszédpanel jelenleg meg van nyitva. A párbeszédpanelt a OFN_EXPLORER jelzővel kell létrehozni; ellenkező esetben az üzenet meghiúsul. |
| CDM_GETFOLDERPATH | Lekéri a jelenleg megnyitott mappa vagy könyvtár elérési útját egy Explorer-stílusú megnyitása vagy Mentés másként párbeszédpanelen. A párbeszédpanelt a OFN_EXPLORER jelzővel kell létrehozni; ellenkező esetben az üzenet meghiúsul. |
| CDM_GETSPEC | Lekéri a jelenleg kijelölt fájl nevét (az elérési utat nem beleértve) egy Explorer-stílusú megnyitása vagy Mentés másként párbeszédpanelen. A párbeszédpanelt a OFN_EXPLORER jelzővel kell létrehozni; ellenkező esetben az üzenet meghiúsul. |
| CDM_HIDECONTROL | Elrejti a megadott vezérlőt egy Explorer-stílusú megnyitása vagy Mentés másként párbeszédpanelen. A párbeszédpanelt a OFN_EXPLORER jelzővel kell létrehozni; ellenkező esetben az üzenet meghiúsul. |
| CDM_SETCONTROLTEXT | Beállítja a megadott vezérlőelem szövegét egy Explorer-stílusú megnyitása vagy Mentés másként párbeszédpanelen. A párbeszédpanelt a OFN_EXPLORER jelzővel kell létrehozni; ellenkező esetben az üzenet meghiúsul. |
| CDM_SETDEFEXT | Beállítja egy Explorer-stílusú megnyitása vagy Mentés másként párbeszédpanel alapértelmezett fájlnévkiterjesztését. A párbeszédpanelt a OFN_EXPLORER jelzővel kell létrehozni; ellenkező esetben az üzenet meghiúsul. |
| SETRGBSTRING | A Szín párbeszédpanel CCHookProca SETRGBSTRING regisztrált üzenetet küldheti a párbeszédpanelre az aktuális színkijelölés beállításához. |
| WM_CHOOSEFONT_GETLOGFONT | Az alkalmazás elküldi a WM_CHOOSEFONT_GETLOGFONT üzenetet egy Betűtípus párbeszédpanelre, hogy információt kérjen a felhasználó aktuális betűtípus-beállításairól. |
| WM_CHOOSEFONT_SETFLAGS | Az alkalmazás elküldi a WM_CHOOSEFONT_SETFLAGS üzenetet egy Betűtípus párbeszédpanelre a párbeszédpanel megjelenítési beállításainak beállításához. |
| WM_CHOOSEFONT_SETLOGFONT | Az alkalmazás elküldi a WM_CHOOSEFONT_SETLOGFONT üzenetet egy Betűtípus párbeszédpanelre az aktuális logikai betűtípus-információk beállításához. |
Értesítések
| Név | Leírás |
|---|---|
| CDN_FILEOK | Explorer-stílusú Megnyitás vagy Mentés másként párbeszédpanelen, amikor a felhasználó megad egy fájlnevet, és az OK gombra kattint. |
| CDN_FOLDERCHANGE | Explorer-stílusú Megnyitás vagy Mentés másként párbeszédpanelen új mappa megnyitásakor. |
| CDN_HELP | Explorer-stílusú Megnyitás vagy Mentés másként párbeszédpanelen, amikor a felhasználó a Súgó gombra kattint. |
| CDN_INCLUDEITEM | Egy Által küldött Megnyitás vagy Mentés másként párbeszédpanelen annak meghatározásához, hogy a párbeszédpanelen megjelenjen-e egy elem a rendszerhéjmappa elemlistájában. Amikor a felhasználó megnyit egy mappát, a párbeszédpanel CDN_INCLUDEITEM értesítést küld a mappa egyes elemeiről. A párbeszédpanel csak akkor küldi el ezt az értesítést, ha a párbeszédpanel létrehozásakor beállította a OFN_ENABLEINCLUDENOTIFY jelzőt. |
| CDN_INITDONE | Explorer-stílusú Nyissa meg vagy Mentés másként párbeszédpanelt, ha a rendszer befejezte a vezérlők rendezését a párbeszédpanelen. A rendszer áthelyezi a szabványos vezérlőket, hogy helyet adjanak a gyermek párbeszédpanel vezérlőinek. |
| CDN_SELCHANGE | Explorer-stílusú Megnyitás vagy Mentés másként párbeszédpanelen, amikor a kijelölés megváltozik a listamezőben, amely az aktuálisan megnyitott mappa vagy könyvtár tartalmát jeleníti meg. |
| CDN_SHAREVIOLATION | Explorer-stílusú megnyitása vagy Mentés másként párbeszédpanelen, amikor a felhasználó az OK gombra kattint, és a kijelölt fájl esetében hálózati megosztási szabálysértés lép fel. |
| CDN_TYPECHANGE | Explorer-stílusú Megnyitás vagy Mentés másként párbeszédpanelen, amikor a felhasználó új fájltípust választ ki a fájltípusok kombinált listájából. |
| COLOROKSTRING | A Szín párbeszédpanel a COLOROKSTRING regisztrált üzenetet küldi a horog eljárásnak, CCHookProc, amikor a felhasználó kiválaszt egy színt, és az OK gombra kattint. A horog eljárás elfogadhatja a színt, és engedélyezheti a párbeszédpanel bezárását, vagy elutasíthatja a színt, és kényszerítheti a párbeszédpanelt, hogy nyitva maradjon. |
| FILEOKSTRING | Egy Megnyitás vagy Mentés másként párbeszédpanel elküldi a FILEOKSTRING regisztrált üzenetet a horog eljárásnak, OFNHookProc, amikor a felhasználó megad egy fájlnevet, és az OK gombra kattint. A horog eljárás elfogadhatja a fájlnevet, és engedélyezheti a párbeszédpanel bezárását, vagy elutasíthatja a fájlnevet, és kényszerítheti a párbeszédpanel megnyitását. |
| FINDMSGSTRING | A Keresés vagy Csere párbeszédpanel a FINDMSGSTRING regisztrált üzenetet küldi a tulajdonosablak ablakának eljárására, amikor a felhasználó a Következőkeresése, Cserevagy Az összes cseréje gombra kattint, vagy bezárja a párbeszédpanelt. |
| HELPMSGSTRING | Egy gyakori párbeszédpanel elküldi a HELPMSGSTRING regisztrált üzenetet a tulajdonosablak ablakának eljárására, amikor a felhasználó a Súgó gombra kattint. |
| LBSELCHSTRING | Egy Megnyitás vagy Mentés másként párbeszédpanel a LBSELCHSTRING regisztrált üzenetet küldi a horog eljárásnak, amikor a kijelölés a párbeszédpanel listamezőiben vagy kombinált listájában megváltozik. |
| SHAREVISTRING | Egy Megnyitás vagy Mentés másként párbeszédpanel a SHAREVISTRING regisztrált üzenetet küldi a horog eljárásnak, OFNHookProc, ha megosztási szabálysértés történik a kijelölt fájlban, amikor a felhasználó az OK gombra kattint. |
| WM_PSD_ENVSTAMPRECT | Értesíti a Lapbeállítási párbeszédpanel PagePaintHookhorog eljárásáról, hogy a párbeszédpanel a mintalap borítékbélyegző téglalapjának megrajzolására készül. |
| WM_PSD_FULLPAGERECT | A Lapbeállítás párbeszédpanelen értesíti a PagePaintHook a mintalap téglalapjának koordinátáit. A párbeszédpanel akkor küldi el ezt az üzenetet, amikor a mintalap tartalmának megrajzolására készül. |
| WM_PSD_GREEKTEXTRECT | Értesíti a Lapbeállítás párbeszédpanel PagePaintHookhorog eljárásáról, hogy a párbeszédpanel görög szöveget fog rajzolni a mintalap margó téglalapján belül. |
| WM_PSD_MARGINRECT | Értesíti a Lapbeállítás párbeszédpanel PagePaintHookhorog eljárásáról, hogy a párbeszédpanel a mintalap margó téglalapjának megrajzolására készül. |
| WM_PSD_MINMARGINRECT | Értesíti a PagePaintHook horog eljárást a mintalap margó téglalapjának koordinátáiról. A lapbeállítási párbeszédpanel akkor küldi el ezt az üzenetet, amikor a mintalap tartalmának megrajzolására készül. |
| WM_PSD_PAGESETUPDLG | Értesíti a PagePaintHook horog eljárást, amely szerint a Lapbeállítási párbeszédpanel a mintalap tartalmának megrajzolására készül. A horog eljárás ezt az üzenetet használhatja a mintalap tartalmának megrajzolásával kapcsolatos inicializálási feladatok végrehajtására. |
| WM_PSD_YAFULLPAGERECT | Értesíti a Lapbeállítás párbeszédpanel PagePaintHookhorog eljárásáról, hogy a párbeszédpanel egy borítékmintalap visszatérési címének egy részét rajzolja meg. |
Struktúrák
| Név | Leírás |
|---|---|
| CHOOSECOLOR | Az Szín párbeszédpanel inicializálásához használt ChooseColor függvény adatait tartalmazza. Miután a felhasználó bezárta a párbeszédpanelt, a rendszer adatokat ad vissza a felhasználó kiválasztásáról ebben a struktúrában. |
| CHOOSEFONT | Az ChooseFont függvény által a Betűtípus párbeszédpanel inicializálásához használt információkat tartalmazza. Miután a felhasználó bezárta a párbeszédpanelt, a rendszer adatokat ad vissza a felhasználó kiválasztásáról ebben a struktúrában. |
| DEVNAMES | Olyan sztringeket tartalmaz, amelyek azonosítják a nyomtató illesztőprogramjának, eszközének és kimeneti portjának nevét. A PrintDlgEx és PrintDlg függvények ezeket a sztringeket használják a rendszer által definiált Tulajdonságlap nyomtatása vagy Nyomtatási párbeszédpanelinicializálásához. Amikor a felhasználó bezárja a tulajdonságlapot vagy a párbeszédpanelt, a rendszer ebben a struktúrában adja vissza a kiválasztott nyomtató adatait. |
| FINDREPLACE | Az Szövegkereső és Helyettesítő szöveg függvény által a keresése és Csere párbeszédpanelek inicializálásához használt információkat tartalmazza. A FINDMSGSTRING regisztrált üzenet ezzel a struktúrával továbbítja a felhasználó keresési vagy cserebemenetét egy Keresés vagy Csere párbeszédpanel tulajdonosablakába. |
| OFNOTIFY | A Megnyitás vagy Mentés másként párbeszédpanel OFNHookProc hook eljárásának küldött WM_NOTIFY üzenetről szóló információk. Az WM_NOTIFY üzenet lParam paramétere egy OFNOTIFY struktúrára mutató mutató. |
| OFNOTIFYEX | Információkat tartalmaz egy CDN_INCLUDEITEM értesítési üzenetről. |
| OPENFILENAME | Az GetOpenFileName és GetSaveFileName függvény által a Megnyitás vagy Mentés másként párbeszédpanel inicializálásához használt információkat tartalmazza. Miután a felhasználó bezárta a párbeszédpanelt, a rendszer adatokat ad vissza a felhasználó kiválasztásáról ebben a struktúrában. |
| OPENFILENAME_NT4 | Megegyezik OPENFILENAME _WIN32_WINNT 0x0400 beállítással. |
| PAGESETUPDLG | Az PageSetupDlg függvény az Lapbeállítás párbeszédpanel inicializálásához használt információkat tartalmazza. Miután a felhasználó bezárta a párbeszédpanelt, a rendszer adatokat ad vissza a felhasználó által megadott oldalparaméterekről ebben a struktúrában. |
| PRINTDLG | Az PrintDlg függvény által a Nyomtatás párbeszédpanelinicializálásához használt információkat tartalmazza. Miután a felhasználó bezárta a párbeszédpanelt, a rendszer ezzel a struktúrával adja vissza a felhasználó kijelölésével kapcsolatos információkat. |
| PRINTDLGEX | Az PrintDlgEx függvény által a Print tulajdonságlapinicializálásához használt információkat tartalmazza. Miután a felhasználó bezárta a tulajdonságlapot, a rendszer ezzel a struktúrával adja vissza a felhasználó kijelöléseinek adatait. |
| PRINTPAGERANGE | Egy nyomtatási feladat laptartományát adja meg. A nyomtatási feladatok több oldaltartományt is tartalmazhatnak. Ezek az információk a PRINTDLGEX struktúrában találhatók, amikor meghívja a PrintDlgEx függvényt. |