Vanligt dialogrutebibliotek
Det gemensamma dialogrutebiblioteket innehåller en uppsättning dialogrutor för att utföra vanliga programaktiviteter, till exempel att öppna filer, välja färgvärden och skriva ut dokument. Med de vanliga dialogrutorna kan du implementera en konsekvent metod för programmets användargränssnitt. Detta minskar mängden arbete som användarna lägger ner på att lära sig användargränssnittsbeteende för ditt program.
I det här avsnittet beskrivs de vanliga dialogrutorna som innehåller dialogrutorna Öppna och Spara som fil. dialogrutan Sök efter och Ersätt redigering. Print, Print Setup, Print Property Sheetoch Utskriftsformat utskriftsdialogrutor. och dialogrutorna Color och Font.
Not
Från och med Windows Vista har Öppna och Spara som vanliga dialogrutor ersatts av dialogrutan gemensamt objekt. Vi rekommenderar att du använder DIALOG-API:et för gemensamt objekt i stället för dessa dialogrutor från det gemensamma dialogrutebiblioteket.
I det här avsnittet
| Namn | Beskrivning |
|---|---|
| vanliga dialogrutetyper | Diskuterar de olika dialogrutorna. |
| vanliga dialogruteinitieringsflaggor | Beskriver hur flaggor används för att ändra beteendet och utseendet på en gemensam dialogruta. |
| Anpassa vanliga dialogrutor | Beskriver hur du använder vanliga dialogrutor. |
| Använda vanliga dialogrutor | Omfattar uppgifter som anropar vanliga dialogrutor. |
| gemensam dialogrutereferens | Innehåller API-referensen. |
Funktioner
| Namn | Beskrivning |
|---|---|
| CCHookProc | Tar emot meddelanden eller meddelanden som är avsedda för standarddialogrutan i dialogrutan Color. Det här är en programdefinierad eller biblioteksdefinierad återanropsfunktion som används med funktionen ChooseColor. |
| CFHookProc | Tar emot meddelanden eller meddelanden som är avsedda för standarddialogrutan i dialogrutan Teckensnitt. Det här är en programdefinierad eller biblioteksdefinierad återanropsprocedur som används med funktionen ChooseFont. |
| ChooseColor | Skapar en dialogruta för Color som gör att användaren kan välja en färg. |
| ChooseFont | Skapar en dialogrutan Teckensnitt som gör att användaren kan välja attribut för ett logiskt teckensnitt. Dessa attribut omfattar en teckensnittsfamilj och tillhörande teckensnittsstil, en punktstorlek, effekter (understrykning, utstrykning och textfärg) och ett skript (eller en teckenuppsättning). |
| CommDlgExtendedError | Returnerar en vanlig dialogrutefelkod. Den här koden anger det senaste felet som inträffar under körningen av en av de vanliga dialogrutefunktionerna. |
| FindText | Skapar en systemdefinierad lägeslös dialogrutan Sök som låter användaren ange en sträng att söka efter och alternativ som ska användas vid sökning efter text i ett dokument. |
| FRHookProc | Tar emot meddelanden eller meddelanden som är avsedda för standarddialogruteproceduren i dialogrutan Sök eller Ersätt. Det här är en programdefinierad eller biblioteksdefinierad återanropsfunktion som används med funktionen FindText eller ReplaceText. |
| GetFileTitle | Hämtar namnet på den angivna filen. |
| GetOpenFileName | Skapar en dialogrutan Öppna där användaren kan ange enheten, katalogen och namnet på en fil eller uppsättning filer som ska öppnas. |
| GetSaveFileName | Skapar en dialogrutan Spara som låter användaren ange enheten, katalogen och namnet på en fil som ska sparas. |
| OFNHookProc | Tar emot meddelanden som skickas från dialogrutan. Funktionen tar också emot meddelanden för eventuella ytterligare kontroller som du har definierat genom att ange en underordnad dialogmall. Det här är en programdefinierad eller biblioteksdefinierad återanropsfunktion som används med dialogrutorna Öppna och Spara som. |
| OFNHookProcOldStyle | Tar emot meddelanden eller meddelanden som är avsedda för dialogruteproceduren. Det här är en programdefinierad eller biblioteksdefinierad återanropsfunktion som används med dialogrutorna Öppna och Spara som. |
| PagePaintHook | Tar emot meddelanden som gör att du kan anpassa ritningen av exempelsidan i dialogrutan Utskriftsformat. Det här är en programdefinierad eller biblioteksdefinierad återanropsfunktion som används med funktionen PageSetupDlg. |
| PageSetupDlg | Skapar en dialogruta för utskriftsformat som gör att användaren kan ange attributen för en utskriven sida. Dessa attribut omfattar pappersstorleken och källan, sidorienteringen (stående eller liggande) och sidmarginalernas bredd. |
| PageSetupHook | Tar emot meddelanden eller meddelanden som är avsedda för standarddialogruteproceduren i dialogrutan Utskriftsformat. Det här är en programdefinierad eller biblioteksdefinierad återanropsfunktion som används med funktionenPageSetupDlg. |
| PrintDlg | Visar en utskriftsdialogruta. I dialogrutan Skriv ut kan användaren ange egenskaperna för ett visst utskriftsjobb. |
| PrintDlgEx | Visar ett skriv ut egenskapsblad som gör att användaren kan ange egenskaperna för ett visst utskriftsjobb. EgenskapsbladetPrinthar en sidan Allmänt som innehåller kontroller som liknar dialogrutan Skriv ut. Egenskapsbladet kan också ha ytterligare programspecifika och drivrutinsspecifika egenskapssidor samt sidan Allmänt. |
| PrintHookProc | Tar emot meddelanden eller meddelanden som är avsedda för standarddialogrutan i dialogrutan Skriv ut. Det här är en programdefinierad eller biblioteksdefinierad återanropsfunktion som används med funktionen PrintDlg. |
| ReplaceText | Skapar en systemdefinierad, lägeslös dialogruta där användaren kan ange en sträng att söka efter och en ersättningssträng samt alternativ för att styra sök- och ersättningsåtgärderna. |
| SetupHookProc | En programdefinierad eller biblioteksdefinierad återanropsfunktion som används med funktionen PrintDlg. Hook-proceduren tar emot meddelanden eller meddelanden som är avsedda för standarddialogruteproceduren i dialogrutan Utskriftsinstallation. |
Gränssnitt
| Namn | Beskrivning |
|---|---|
| IPrintDialogCallback | Innehåller metoder som gör det möjligt för ett program att ta emot meddelanden och meddelanden från funktionen PrintDlgEx medan utskriftsegenskapsblad visas. |
| IPrintDialogServices | Innehåller metoder som aktiverar ett program med funktionen PrintDlgEx för att hämta information om den markerade skrivaren. |
Meddelanden
| Namn | Beskrivning |
|---|---|
| CDM_GETFILEPATH | Hämtar sökvägen och filnamnet för den markerade filen i en Explorer-stil dialogrutan Öppna eller Spara som. Dialogrutan måste ha skapats med flaggan OFN_EXPLORER. annars misslyckas meddelandet. |
| CDM_GETFOLDERIDLIST | Hämtar adressen till listan med objektidentifierare som motsvarar mappen som en Explorer-stil Öppna eller dialogrutan Spara som för närvarande har öppen. Dialogrutan måste ha skapats med flaggan OFN_EXPLORER. annars misslyckas meddelandet. |
| CDM_GETFOLDERPATH | Hämtar sökvägen till den öppna mappen eller katalogen för en Explorer-stil dialogrutan Öppna eller Spara som. Dialogrutan måste ha skapats med flaggan OFN_EXPLORER. annars misslyckas meddelandet. |
| CDM_GETSPEC | Hämtar filnamnet (inte sökvägen) för den markerade filen i explorer-stil dialogrutan Öppna eller Spara som. Dialogrutan måste ha skapats med flaggan OFN_EXPLORER. annars misslyckas meddelandet. |
| CDM_HIDECONTROL | Döljer den angivna kontrollen i en explorer-stil dialogrutan Öppna eller Spara som. Dialogrutan måste ha skapats med flaggan OFN_EXPLORER. annars misslyckas meddelandet. |
| CDM_SETCONTROLTEXT | Anger texten för den angivna kontrollen i en explorer-stil dialogrutan Öppna eller Spara som. Dialogrutan måste ha skapats med flaggan OFN_EXPLORER. annars misslyckas meddelandet. |
| CDM_SETDEFEXT | Anger standardfilnamnstillägget för ett Explorer-format dialogrutan Öppna eller Spara som. Dialogrutan måste ha skapats med flaggan OFN_EXPLORER. annars misslyckas meddelandet. |
| SETRGBSTRING- | Hook-proceduren i dialogrutan Color, CCHookProc, kan skicka SETRGBSTRING- registrerat meddelande till dialogrutan för att ange den aktuella färgmarkeringen. |
| WM_CHOOSEFONT_GETLOGFONT | Ett program skickar meddelandet WM_CHOOSEFONT_GETLOGFONT till dialogrutan Teckensnitt för att hämta information om användarens aktuella teckensnittsval. |
| WM_CHOOSEFONT_SETFLAGS | Ett program skickar meddelandet WM_CHOOSEFONT_SETFLAGS till dialogrutan Teckensnitt för att ange visningsalternativen för dialogrutan. |
| WM_CHOOSEFONT_SETLOGFONT | Ett program skickar meddelandet WM_CHOOSEFONT_SETLOGFONT till en dialogruta Teckensnitt för att ange aktuell logisk teckensnittsinformation. |
Meddelanden
| Namn | Beskrivning |
|---|---|
| CDN_FILEOK | Skickas av en explorer-stil Dialogrutan Öppna eller Spara som när användaren anger ett filnamn och klickar på knappen OK. |
| CDN_FOLDERCHANGE | Skickas av en explorer-stil Dialogrutan Öppna eller Spara som när en ny mapp öppnas. |
| CDN_HELP | Skickas av en explorer-stil Öppna eller Dialogrutan Spara som när användaren klickar på knappen Hjälp. |
| CDN_INCLUDEITEM | Skickas av en dialogrutan Öppna eller Spara som för att avgöra om dialogrutan ska visa ett objekt i en gränssnittsmapps objektlista. När användaren öppnar en mapp skickar dialogrutan ett CDN_INCLUDEITEM meddelande för varje objekt i mappen. Dialogrutan skickar endast det här meddelandet om flaggan OFN_ENABLEINCLUDENOTIFY angavs när dialogrutan skapades. |
| CDN_INITDONE | Skickas av en explorer-stil Öppna eller Dialogrutan Spara som när systemet har ordnat kontrollerna i dialogrutan. Systemet flyttar standardkontrollerna för att göra plats för kontrollerna i den underordnade dialogrutan. |
| CDN_SELCHANGE | Skickas av en explorer-stil Öppna eller dialogrutan Spara som när markeringen ändras i listrutan som visar innehållet i den aktuella öppna mappen eller katalogen. |
| CDN_SHAREVIOLATION | Skickas av en explorer-stil Öppna eller Dialogrutan Spara som när användaren klickar på knappen OK och ett brott mot nätverksdelning sker för den valda filen. |
| CDN_TYPECHANGE | Skickas av en explorer-stil Dialogrutan Öppna eller Spara som när användaren väljer en ny filtyp i kombinationsrutan filtyper. |
| COLOROKSTRING | I dialogrutan Color skickas COLOROKSTRING- registrerat meddelande till din hook-procedur, CCHookProc, när användaren väljer en färg och klickar på knappen OK. Krokproceduren kan acceptera färgen och tillåta att dialogrutan stängs, eller avvisa färgen och tvinga dialogrutan att förbli öppen. |
| FILEOKSTRING- | En dialogrutan Öppna eller Spara som skickar FILEOKSTRING- registrerat meddelande till hookproceduren, OFNHookProc, när användaren anger ett filnamn och klickar på knappen OK. Hook-proceduren kan acceptera filnamnet och tillåta att dialogrutan stängs, eller avvisa filnamnet och tvinga dialogrutan att förbli öppen. |
| FINDMSGSTRING- | I dialogrutan Sök efter eller Ersätt skickas FINDMSGSTRING- registrerat meddelande till fönsterproceduren i ägarfönstret när användaren klickar på Sök nästa, Ersätteller ersätt alla eller stänger dialogrutan. |
| HELPMSGSTRING- | En vanlig dialogruta skickar HELPMSGSTRING- registrerat meddelande till fönsterproceduren i dess ägarfönster när användaren klickar på knappen Hjälp. |
| LBSELCHSTRING- | En dialogrutan Öppna eller Spara som skickar LBSELCHSTRING- registrerat meddelande till din krokprocedur när markeringen ändras i någon av listrutorna eller kombinationsrutorna i dialogrutan. |
| SHAREVISTRING- | En dialogrutan Öppna eller Spara som skickar SHAREVISTRING- registrerat meddelande till din hook-procedur, OFNHookProcom en delningsöverträdelse inträffar för den valda filen när användaren klickar på knappen OK. |
| WM_PSD_ENVSTAMPRECT | Meddelar hook-proceduren i dialogrutan Utskriftsformat, PagePaintHook, att dialogrutan håller på att rita kuvertstämpelrektangeln på exempelsidan. |
| WM_PSD_FULLPAGERECT | Meddelar en PagePaintHook krokprocedur för koordinaterna för exempelsidans rektangel i dialogrutan Utskriftsformat. Dialogrutan skickar det här meddelandet när det är på väg att rita innehållet på exempelsidan. |
| WM_PSD_GREEKTEXTRECT | Meddelar hook-proceduren för en utskriftsformat dialogruta, PagePaintHook, att dialogrutan är på väg att rita grekisk text inuti marginalrektangeln på exempelsidan. |
| WM_PSD_MARGINRECT | Meddelar hook-proceduren för en dialogruta för sida, PagePaintHook, att dialogrutan håller på att rita marginalrektangeln på exempelsidan. |
| WM_PSD_MINMARGINRECT | Meddelar en PagePaintHook krokprocedur för koordinaterna för marginalrektangeln på exempelsidan. En dialogruta utskriftsformat skickar det här meddelandet när det är på väg att rita innehållet på exempelsidan. |
| WM_PSD_PAGESETUPDLG | Meddelar en PagePaintHook hook-procedur att dialogrutan Page Setup håller på att rita innehållet på exempelsidan. Hook-proceduren kan använda det här meddelandet för att utföra initieringsuppgifter som rör ritning av innehållet på exempelsidan. |
| WM_PSD_YAFULLPAGERECT | Meddelar krokproceduren för en dialogruta för utskriftsformat, PagePaintHook, att dialogrutan är på väg att rita returadressdelen av en kuvertexempelsida. |
Strukturer
| Namn | Beskrivning |
|---|---|
| CHOOSECOLOR | Innehåller information som funktionen ChooseColor använder för att initiera dialogrutan Color. När användaren har stängt dialogrutan returnerar systemet information om användarens val i den här strukturen. |
| CHOOSEFONT- | Innehåller information som funktionen ChooseFont använder för att initiera dialogrutan Teckensnitt. När användaren har stängt dialogrutan returnerar systemet information om användarens val i den här strukturen. |
| DEVNAMES- | Innehåller strängar som identifierar drivrutins-, enhets- och utdataportnamnen för en skrivare. Funktionerna PrintDlgEx och PrintDlg använder dessa strängar för att initiera den systemdefinierade utskriftsegenskapsdokumentet eller dialogrutan utskrift. När användaren stänger egenskapsbladet eller dialogrutan returneras information om den valda skrivaren i den här strukturen. |
| FINDREPLACE | Innehåller information som funktionerna FindText och ReplaceText använder för att initiera dialogrutorna Sök och Ersätt. Det FINDMSGSTRING- registrerade meddelandet använder den här strukturen för att skicka användarens sök- eller ersättningsindata till ägarfönstret för en dialogrutan Sök eller Ersätt. |
| OFNOTIFY | Ccontains information om ett WM_NOTIFY meddelande som skickas till en OFNHookProc hook-procedur för en dialogrutan Öppna eller Spara som. Parametern lParam i WM_NOTIFY-meddelandet är en pekare till en OFNOTIFY- struktur. |
| OFNOTIFYEX | Innehåller information om ett CDN_INCLUDEITEM meddelandemeddelande. |
| OPENFILENAME | Innehåller information som funktionerna GetOpenFileName och GetSaveFileName använder för att initiera en dialogrutan Öppna eller Spara som. När användaren har stängt dialogrutan returnerar systemet information om användarens val i den här strukturen. |
| OPENFILENAME_NT4 | Identisk med OPENFILENAME- med _WIN32_WINNT inställt på 0x0400. |
| PAGESETUPDLG | Innehåller information som funktionen PageSetupDlg använder för att initiera dialogrutan Utskriftsformat. När användaren har stängt dialogrutan returnerar systemet information om de användardefinierade sidparametrarna i den här strukturen. |
| PRINTDLG- | Innehåller information som funktionen PrintDlg använder för att initiera dialogrutan utskrift. När användaren har stängt dialogrutan använder systemet den här strukturen för att returnera information om användarens val. |
| PRINTDLGEX | Innehåller information som funktionen PrintDlgEx använder för att initiera egenskapsbladet Print. När användaren har stängt egenskapsbladet använder systemet den här strukturen för att returnera information om användarens val. |
| PRINTPAGERANGE | Anger ett intervall med sidor i ett utskriftsjobb. Ett utskriftsjobb kan ha fler än ett sidintervall. Den här informationen anges i PRINTDLGEX- struktur när du anropar funktionen PrintDlgEx. |