Vanliga dialogrutetyper
Det gemensamma dialogrutebiblioteket innehåller en funktion för att skapa och en struktur för varje typ av gemensam dialogruta. Om du vill använda en gemensam dialogruta i det enklaste formuläret anropar du dess skapandefunktion och anger en pekare till en struktur som innehåller inledande värden och alternativflaggor. När dialogrutan har initierats använder dialogruteproceduren strukturen för att returnera information om användarens indata. Du kan också anpassa en gemensam dialogruta som passar programmets behov.
Följande tabell innehåller en kort beskrivning av de olika typerna av vanliga dialogrutor och visar funktionen och strukturen som används för varje typ.
| Dialogruta | Beskrivning |
|---|---|
|
färg |
Visar tillgängliga färger och om du vill kan användaren skapa anpassade färger. Användaren kan välja en grundläggande eller anpassad färg. Använd funktionen ChooseColor och CHOOSECOLOR- struktur. Mer information finns i dialogrutan color. |
|
Hitta |
Visar en dialogruta där användaren kan skriva strängen som ska hittas. Användaren kan också ange sökalternativ, till exempel sökriktningen och om sökningen är skiftlägeskänslig. Använd funktionen FindText och FINDREPLACE- struktur. Mer information finns i Sök och ersätt dialogrutor. |
|
teckensnitt |
Visar en dialogruta där användaren kan välja en teckensnittsfamilj och tillhörande teckensnittsstil, punktstorlekar och andra teckensnittsattribut som teckenfärg, understrykning eller genomstrykning. Använd funktionen ChooseFont och CHOOSEFONT- struktur. Mer information finns i dialogrutan teckensnitt. |
|
Öppna |
Visar en dialogruta där användaren kan skriva eller välja namnet på en fil eller ett gränssnittsnamn-blankstegsobjekt som ska öppnas. Dialogrutan innehåller listor över enheter, kataloger och tillägg för shell name-space som gör det möjligt för användaren att bläddra i gränssnittets namnutrymme. Den innehåller också en lista över filnamnstillägg som gör det möjligt för användaren att filtrera de filnamn som visas. Använd funktionen GetOpenFileName och OPENFILENAME- struktur. Mer information finns i öppna och spara som dialogrutor. |
|
Utskriftsformat |
Visar den aktuella sidkonfigurationen. Användaren kan välja alternativ för sidkonfiguration, till exempel pappersorientering, storlek, källa och marginaler. Använd funktionen PageSetupDlg och PAGESETUPDLG struktur. Mer information finns i dialogrutan utskriftsformat. |
|
Skriv ut |
Visar information om den installerade skrivaren och dess konfiguration. Användaren kan välja utskriftsalternativ, till exempel det intervall med sidor som ska skrivas ut och antalet kopior, och starta utskriftsprocessen. Använd funktionen PrintDlg och PRINTDLG- struktur. Mer information finns i dialogrutan Utskrift. Om du vill visa ett utskrifts- egenskapsblad i stället för en dialogruta för Print använder du funktionen PrintDlgEx med PRINTDLGEX- struktur. Sidan Allmänt i egenskapsbladet liknar dialogrutan Skriv ut. Egenskapsbladet kan ha ytterligare programspecifika och drivrutinsspecifika egenskapssidor på sidan Allmänt. Mer information finns i Print Property Sheet. |
|
Ersätt |
Visar en dialogruta där användaren kan skriva strängen för att hitta och ersättningssträngen. Användaren kan ange sökalternativ, till exempel om sökningen är skiftlägeskänslig och ersättningsalternativ, till exempel ersättningsomfånget. Använd funktionen ReplaceText och FINDREPLACE- struktur. Mer information finns i Sök och ersätt dialogrutor. |
|
Spara som |
Visar en dialogruta där användaren kan skriva eller välja det namn som ett fil- eller gränssnittsnamn-blankstegsobjekt ska sparas med. Dialogrutan innehåller listor över enheter, kataloger och tillägg för shell name-space som gör det möjligt för användaren att bläddra i gränssnittets namnutrymme. Den innehåller också en lista över filnamnstillägg som gör det möjligt för användaren att filtrera de filnamn som visas. Använd funktionen GetSaveFileName och OPENFILENAME- struktur. Mer information finns i öppna och spara som dialogrutor. |
Även om det finns en dialogrutan Utskriftsinstallation har den ersatts av dialogrutan Utskriftsformat. Program bör använda dialogrutan utskriftsformat i stället för dialogrutan Utskriftsinstallation.
Alla vanliga dialogrutor är modala, förutom dialogrutorna Sök efter och Ersätt. Modala dialogrutor måste stängas av användaren innan den funktion som används för att skapa dialogrutan kan returneras. Dialogrutorna Find and Replace är lägeslösa. funktionen returnerar innan dialogrutan stängs. Om du använder dialogrutorna Find och Replace måste du också använda funktionen IsDialogMessage i huvudmeddelandeloopen i programmet för att säkerställa att dessa dialogrutor bearbetar tangentbordsinmatningen korrekt, till exempel TAB- och ESC-tangenterna.