DLGTEMPLATE

Struktura DLGTEMPLATE określa wymiary i stylu pojawia się okno dialogowe. Ta struktura, zawsze pierwszy standardowy szablon pojawia się okno dialogowe, również określa liczbę formantów w oknie dialogowym i dlatego określa liczbę kolejnych DLGITEMTEMPLATE struktur w szablonie.

element TypeDef struct {/ / dltt DWORD stylu; 
    DWORD dwExtendedStyle; 
    Program WORD cdit; 
    krótkie x; 
    krótkie y; 
    krótkie cx; 
    cy krótki; 
} DLGTEMPLATE 

 

Członkowie

styl
Określa styl okna dialogowego. Ten element może być kombinacją wartości styl okna (na przykład WS_CAPTION i WS_SYSMENU) i jeden lub więcej następujących wartości stylu pole dialogowe:
Wartość Znaczenie
DS_3DLOOK Przedstawia okno dialogowe czcionkę nonbold i rysuje trójwymiarowego obramowania wokół kontroli systemu windows w oknie dialogowym.

Styl DS_3DLOOK jest wymagane przez aplikacje oparte na Win32, sporządzanych dla systemów starszych niż system Windows 95 lub Windows NT 4.0. System automatycznie stosuje trójwymiarowy wygląd do okien dialogowych utworzonych przez aplikacje opracowane dla bieżącej wersji systemu.

DS_ABSALIGN Wskazuje, że współrzędne okna dialogowego współrzędnymi ekranowymi. Jeśli styl ten nie jest określona, system zakłada, że są one współrzędne klienta.
DS_CENTER Wyśrodkowuje okna dialogowego w obszarze roboczym; oznacza to, że obszar nie zasłonięte przez zasobnik.
DS_CENTERMOUSE Wyśrodkowuje kursor myszy w oknie dialogowym.
DS_CONTEXTHELP Zawiera znak zapytania w pasku tytułu okna dialogowego. Kiedy użytkownik kliknie znak zapytania, kursor zmienia na znak zapytania ze wskaźnika. Jeśli użytkownik klika formantu w oknie dialogowym, formant uzyskuje komunikat WM_HELP. Kontrolę należy przekazać wiadomości procedurze w polu okna dialogowego, które powinny wywołać WinHelp funkcji za pomocą polecenia HELP_WM_HELP. Aplikacja Pomoc wyświetla wyskakujące okno, w którym zazwyczaj zawiera pomoc dla formantu.

Należy zauważyć, że DS_CONTEXTHELP jest tylko element zastępczy. Tworzenia okna dialogowego system sprawdza DS_CONTEXTHELP i, jeśli ma, dodaje WS_EX_CONTEXTHELP do rozszerzonego styl okna dialogowego. WS_EX_CONTEXTHELP nie mogą być używane z style WS_MAXIMIZEBOX lub WS_MINIMIZEBOX.

DS_CONTROL Tworzy okno dialogowe, które działa również jako okna podrzędnego innego okna dialogowego, podobnie jak strony w arkuszu właściwości. Ten styl zezwala użytkownikowi na karcie wśród okien sterowania okno dialogowe dziecka, jego klawiszy skrótu i tak dalej.
DS_FIXEDSYS Powoduje, że okno dialogowe do stosowania SYSTEM_FIXED_FONT zamiast domyślnej SYSTEM_FONT. SYSTEM_FIXED_FONT jest zgodny z czcionki systemowej w wersji systemu Windows starszych niż 3.0 czcionka o stałej szerokości.
DS_LOCALEDIT Dotyczy to tylko aplikacji 16-bitowych. Ten styl kieruje edycyjnym w oknie dialogowym przydzielić pamięci z segmentów danych aplikacji. W przeciwnym wypadku edytowanie formantów przydzielić pamięci masowej z obiektu globalnej pamięci.
DS_MODALFRAME Tworzy okno dialogowe z ramką modalne okno dialogowe, którą można łączyć z paska tytułu i menu systemowe określając style WS_CAPTION i WS_SYSMENU.
DS_NOFAILCREATE Systemu Windows 95: Tworzy okno dialogowe, nawet jeśli występują błędy — na przykład, jeśli nie można utworzyć okna podrzędnego lub jeśli system nie może utworzyć segment specjalne dane dla formant edycyjny.
DS_NOIDLEMSG Pomija komunikaty WM_ENTERIDLE, które system inaczej będzie wysyłać do właściciela okna dialogowego podczas gdy wyświetlane jest okno dialogowe.
DS_SETFONT Wskazuje, że nagłówek szablonu pole dialogowe zawiera dodatkowe dane, określając czcionki dla tekstu w obszarze klienta i formanty okna dialogowego. Dane czcionki rozpoczyna się na granicy słowa , który następuje tablicy tytuł. Określa wartość rozmiaru 16-bitowe i ciąg nazwy czcionek Unicode. Jeśli to możliwe system tworzy czcionkę zgodnie z określonej wartości. Następnie system przechodzi uchwyt Czcionka aby oknie i do każdego formantu przesyłając komunikat WM_SETFONT.

Jeśli styl ten nie jest określona, szablon pole dialogowe nie zawierają danych czcionek.

DS_SETFOREGROUND Powoduje, że system, aby używać funkcji SetForegroundWindow aby oknie na pierwszym planie.
DS_SYSMODAL Styl ten jest przestarzały i nie jest włączone dla zachowania zgodności ze starszymi wersjami systemu Windows. Jeśli określisz ten styl, system tworzy okno dialogowe Styl WS_EX_TOPMOST. Nie połączyć ten styl stylem DS_CONTROL.

dwExtendedStyle
Określa rozszerzone style dla okna. Członek ten nie jest używany do tworzenia okien dialogowych, ale aplikacje korzystające z okna dialogowego pole szablony można go użyć na tworzenie innych typów systemu Windows.
cdit
Określa liczbę elementów w oknie dialogowym.
x
Określa współrzędną x, w oknie dialogowym pole jednostek, lewym górnym rogu okna dialogowego.
y
Określa współrzędną y, w oknie dialogowym pole jednostek, lewym górnym rogu okna dialogowego.
cx
Określa szerokość, w oknie dialogowym pole jednostek, okno dialogowe.
cy
Określa wysokość, w oknie dialogowym pole jednostek, okno dialogowe.

Uwagi

W szablonie standardowym okna dialogowego struktura DLGTEMPLATE zawsze natychmiast następuje trzech tablice o zmiennej długości, które określają menu, klasy i tytuł okna dialogowego. Jeśli podany jest styl DS_SETFONT, tych tablic również są następuje 16-bitową wartość określającą rozmiar w punktach i innym tablicy o zmiennej długości, określając nazwę czcionki. Każda tablica składa się z jednego lub więcej elementów 16-bitowych. Menu, klasy, tytuł i czcionki tablic muszą być dostosowane do programu WORD granice.

Natychmiast po struktury DLGTEMPLATE jest tablicą menu, który identyfikuje zasób menu w oknie dialogowym. Jeśli pierwszy element tej tablicy jest 0x0000, okno dialogowe ma nie menu i Tablica nie ma żadnych innych elementów. Jeśli pierwszy element 0xFFFF, tablica ma jeden dodatkowy element, który określa wartości porządkowej zasobu menu w pliku wykonywalnym. Jeśli pierwszy element ma inną wartość, system traktuje tablicy jako ciąg Unicode zakończonym znakiem null, który określa nazwę zasobu menu w pliku wykonywalnym.

Po tablicy menu jest tablicy klasy, która identyfikuje klasy okno formantu. Jeśli pierwszy element tablicy jest 0x0000, system używa klasy pole dialogowe wstępnie zdefiniowanych w oknie dialogowym i Tablica nie ma żadnych innych elementów. Jeśli pierwszy element 0xFFFF, tablica ma jeden dodatkowy element, który określa wartości porządkowej klasy okno system wstępnie zdefiniowanych. Jeśli pierwszy element ma inną wartość, system traktuje tablicy jako ciąg Unicode zakończonym znakiem null, który określa nazwę klasy okno zarejestrowane.

Po tablicy klasy jest tablicą tytuł, który określa ciąg Unicode zakończonym znakiem null, który zawiera tytuł okna dialogowego. Jeśli pierwszy element tej tablicy jest 0x0000, okno dialogowe ma bez tytułu i Tablica nie ma żadnych innych elementów.

Wartość rozmiaru pkt 16-bitowe i tablicy kroju czcionki wykonaj tablicy tytuł, ale tylko wtedy, jeśli członek styl określa styl DS_SETFONT. Wartość rozmiaru punktu określa rozmiar czcionki dla tekstu w oknie dialogowym i jego formantach. Tablica kroju czcionki jest określający nazwę krój czcionki ciągiem Unicode zakończonym znakiem null. Gdy te wartości są podane, system tworzy czcionka dany rozmiar i kroju czcionki (jeśli możliwe) i wysyła wiadomość WM_SETFONT procedury pole dialogowe i okna procedur kontrolnych, jak tworzy okno dialogowe i formanty.

Po nagłówku DLGTEMPLATE w szablonie pole standardowe okno dialogowe są jeden lub więcej struktur DLGITEMTEMPLATE , które określają wymiary i styl formantów w oknie dialogowym. Członek cdit określa liczbę DLGITEMTEMPLATE struktur w szablonie. Struktury te DLGITEMTEMPLATE muszą być dostosowane do typu DWORD granice.

Jeśli określisz ciągów znaków w menu, klasy, tytuł lub tablice kroju czcionki, należy użyć ciągów Unicode. Aby utworzyć kod, który działa w systemie Windows i Windows NT, należy użyć funkcji MultiByteToWideChar do generowania tych ciągów Unicode.

Członkowie x, y, cxi cy określić wartości w oknie dialogowym pole jednostkach. Te wartości można przekonwertować na ekranie jednostek (w pikselach), za pomocą funkcji MapDialogRect.

Skrócone informacje

nbsp; Windows &NT: wymagana wersja 3.1 lub nowsza.
Systemu Windows:Wymaga systemu Windows 95 lub nowszego.
Systemu Windows CE:Wymaga wersja 1.0 lub nowsza.
Nagłówka:Zadeklarowane w pliku winuser.h.

Zobacz też

Omówienie pola dialogowego, okno dialogowe pole struktur, CreateDialogIndirect, CreateDialogIndirectParam, DialogBoxIndirect, DialogBoxIndirectParam, DLGITEMTEMPLATE, DLGITEMTEMPLATEEX, DLGTEMPLATEEX, MapDialogRect, MultiByteToWideChar

Index