Iczelion - 11 - Mehr über Dialog Boxen |joachimrohde.com

Tutorial 11: Mehr über Dialog Boxen

Wir werden mehr über Dialog Boxen in diesem Tutorial lernen. Insbesondere werden wir uns dem Thema widmen, wie wir Dialog Boxen als unsere Eingabe-Ausgabe Geräte benutzen können. Wenn Sie das vorherige Tutorial gelesen haben, wird dieses Tutorial ein Kinderspiel, da nur eine kleine Modifikationen nötig ist, um unsere Dialog Boxen als Beigabe unseres Hauptfensters zu benutzen. Wir werden in diesem Tutorial auch lernen, wie Standard Dialog Boxen benutzt werden.

Laden Sie die Dialog Box Beispiele hier und hier herunter. Laden Sie das gebräuchliche Dialog Box Beispiele hier herunter.

Theorie:
Sehr wenig wurde darüber gesagt, wie man Dialog Boxen als Eingabe-Ausgabe Geräte unseres Programms verwenden kann. Ihr Programm erzeugt das Hauptfenster und wenn Sie eine Dialog Box anzeigen wollen, rufen Sie einfach CreateDialogParam oder DialogBoxParam auf. Beim Aufruf von DialogBoxParam müssen Sie nichts mehr machen, nur noch die Nachrichten in der Dialog-Box Prozedur bearbeiten. Bei CreateDialogParam müssen Sie einen IsDialogMessage Aufruf in der Message-Loop einfügen, um den Dialog Box Manager die Tastatur-Navigation in ihrer Dialog Box für Sie zu händeln. Da beide Fälle ziemlich trivial sind, werde ich den Source Code hier nicht angeben. Sie können die Beispiele herunterladen und selbst betrachte, hier und hier.
Kommen wir zu den Standard-Dialog-Boxen. Windows hat einige vordefinierte Dialog Boxen, die von Ihren Applikationen gebraucht werden können. Diese Dialog Boxen existieren, um ein Standardisiertes Interface zu bieten. Sie bestehen aus, Datei, Druck, Farbe, Schriftart und Such Dialog-Boxen. Sie sollten sie so häufig wie möglich verwenden. Die Dialog-Boxen befinden sich in der comdlg32.dll. Um sie zu benutzen, müssen Sie comdlg32.lib hinzulinken. Sie erzeugen diese Dialog-Boxen indem Sie vorgefertigte Funktionen aus der Standard-Dialog-Library aufrufen. Für einen Datei-öffnen-Dialog ist es GetOpenFileName, für einen Speichern unter-Dialog ist es GetSaveFileName, für einen Drucken-Dialog ist es PrintDlg und so weiter. Jede dieser Funktion wird ein Zeiger auf eine Struktu als Parameter übergeben. Sie sollten sie in der Win32 API Referenz nachschlagen. In diesem Tutorial werde ich ihnen demonstrieren, wie man einen Datei-öffnen-Dialog erzeugt und benutzt.

Unten ist der Funktions-Prototyp der GetOpenFileName-Funktion:

GetOpenFileName proto lpofn:DWORD

Wie Sie sehen können, wird nur ein Parameter übergeben, ein Zeiger auf eine OPNFILENAME-Struktur. Der Rückgabewert TRUE bedeutet, dass der Benutzer eine Datei zum öffnen ausgewählt hat, ansonsten ist er FALST. Wir werfen als nächstes einen Blick auf die OPENFILENAME-Struktur.

OPENFILENAME STRUCT lStructSize DWORD ? hwndOwner HWND ? hInstance HINSTANCE ? lpstrFilter LPCSTR ? lpstrCustomFilter LPSTR ? nMaxCustFilter DWORD ? nFilterIndex DWORD ? lpstrFile LPSTR ? nMaxFile DWORD ? lpstrFileTitle LPSTR ? nMaxFileTitle DWORD ? lpstrInitialDir LPCSTR ? lpstrTitle LPCSTR ? Flags DWORD ? nFileOffset WORD ? nFileExtension WORD ? lpstrDefExt LPCSTR ? lCustData LPARAM ? lpfnHook DWORD ? lpTemplateName LPCSTR ? OPENFILENAME ENDS

Schauen wir uns die Bedeutung der am häufig genutzten Elemente an.

lStructSize Die Größe der OPENFILENAME Struktur , in Bytes

hwndOwner Das Fenster-Handle der Datei-öffnen Dialog Box.

hInstance Instanz Handle der Applikation, die die Datei-öffnen Dialog Box erzeugt.

lpstrFilter Die Filter-Strings im Format gepaarter nullterminierter Strings. Der erste String in jedem Paar ist die Beschreibung. Der zweite String ist das Filter-Pattern. Zum Beispiel:

     FilterString   db "Alle Dateien (*.*)",0, "*.*",0
                            db "Text Dateien (*.txt)",0,"*.txt",0,0

Beachten Sie, dass nur das Pattern im zweiten String in jedem Paar von Windows wirklich benutzt wird, um Dateien auszufiltern. Beachten Sie auch, dass Sie eine extra 0 am Ende der Filter-Strings plazieren müssen, um das Ende zu kennzeichnen.

nFilterIndex Spezifiziert welches Paar der Filter-Strings zur Initialisierung benutzt wird, wenn der Datei-öffnen Dialog das erste Mal angezeigt wird. Der Index beginnt bei 1, das heißt, dass erste Paar ist 1, das zweite Paar ist 2, usw. In dem obigen Beispiel, würde, wenn wir nFilterIndex gleich 2 setzen, das zweite Pattern benutzt werden, also "*.txt".

lpstrFile Zeiger auf den Buffer, der den Dateinamen enthält, welcher benutzt wird um das Dateiname-Edit-Steuerelement zu initialisieren. Der Buffer sollte mindestens 260 Bytes groß sein.

Nachdem der Benutzer eine Datei zum öffnen ausgewählt hat, wird der Dateiname mit dem kompletten Pfad in diesem Buffer gespeichert. Sie können die Informationen später hieraus extrahieren.

nMaxFile Die Größe des lpstrFile Buffer.

lpstrTitle Zeiger auf den Titel der Datei-Öffnen Dialog Box.

Flags Bestimmt die Stile und Charakteristika der Dialog Box.

nFileOffset Nachdem der Benutzer eine Datei zum Öffnen ausgewählt hat, enthält dieses Element den Index des ersten Buchstabens, des aktuellen Dateinnamen. Wenn der volle Name zum Beispiel "c:\windows\system\lz32.dll lautet, dann enthält dieses Element den Wert 18.

nFileExtension Nachdem der Benutzer eine Datei zum Öffnen ausgewählt hat, enthält dieses Element den Index des ersten Buchstabens, der Datei-Extension.

Beispiel:
Das folgende Programm zeigt eine Datei-öffnen Dialog box an, wenn der Benutzer Datei - öffnen aus dem Menü auswählt. Wenn der Benutzer eine Datei in der Dialog Box auswählt, zeigt das Programm eine MessageBox an, die den kompletten Namen, Dateinamen und Extension der selektierten Datei enthält.

.386 .model flat,stdcall option casemap:none WinMain proto :DWORD,:DWORD,:DWORD,:DWORD include \masm32\include\windows.inc include \masm32\include\user32.inc include \masm32\include\kernel32.inc include \masm32\include\comdlg32.inc includelib \masm32\lib\user32.lib includelib \masm32\lib\kernel32.lib includelib \masm32\lib\comdlg32.lib .const IDM_OPEN equ 1 IDM_EXIT equ 2 MAXSIZE equ 260 OUTPUTSIZE equ 512 .data ClassName db "SimpleWinClass",0 AppName db "Our Main Window",0 MenuName db "FirstMenu",0 ofn OPENFILENAME FilterString db "Alle Dateien",0,"*.*",0 db "Text Dateien",0,"*.txt",0,0 buffer db MAXSIZE dup(0) OurTitle db "-=Unser erster Datei öffnen Dialog =-: Wählen Sie eine Datei zum öffnen ",0 FullPathName db "Der komplette Dateiname mit Pfad ist: ",0 FullName db "Der Dateiname ist: ",0 ExtensionName db "Die Extension ist: ",0 OutputString db OUTPUTSIZE dup(0) CrLf db 0Dh,0Ah,0 .data? hInstance HINSTANCE ? CommandLine LPSTR ? .code start: invoke GetModuleHandle, NULL mov hInstance,eax invoke GetCommandLine mov CommandLine,eax invoke WinMain, hInstance,NULL,CommandLine, SW_SHOWDEFAULT invoke ExitProcess,eax WinMain proc hInst:HINSTANCE,hPrevInst:HINSTANCE,CmdLine:LPSTR,CmdShow:DWORD LOCAL wc:WNDCLASSEX LOCAL msg:MSG LOCAL hwnd:HWND mov wc.cbSize,SIZEOF WNDCLASSEX mov wc.style, CS_HREDRAW or CS_VREDRAW mov wc.lpfnWndProc, OFFSET WndProc mov wc.cbClsExtra,NULL mov wc.cbWndExtra,NULL push hInst pop wc.hInstance mov wc.hbrBackground,COLOR_WINDOW+1 mov wc.lpszMenuName,OFFSET MenuName mov wc.lpszClassName,OFFSET ClassName invoke LoadIcon,NULL,IDI_APPLICATION mov wc.hIcon,eax mov wc.hIconSm,eax invoke LoadCursor,NULL,IDC_ARROW mov wc.hCursor,eax invoke RegisterClassEx, addr wc invoke CreateWindowEx,WS_EX_CLIENTEDGE,ADDR ClassName,ADDR AppName,\ WS_OVERLAPPEDWINDOW,CW_USEDEFAULT,\ CW_USEDEFAULT,300,200,NULL,NULL,\ hInst,NULL mov hwnd,eax invoke ShowWindow, hwnd,SW_SHOWNORMAL invoke UpdateWindow, hwnd .WHILE TRUE invoke GetMessage, ADDR msg,NULL,0,0 .BREAK .IF (!eax) invoke TranslateMessage, ADDR msg invoke DispatchMessage, ADDR msg .ENDW mov eax,msg.wParam ret WinMain endp WndProc proc hWnd:HWND, uMsg:UINT, wParam:WPARAM, lParam:LPARAM .IF uMsg==WM_DESTROY invoke PostQuitMessage,NULL .ELSEIF uMsg==WM_COMMAND mov eax,wParam .if ax==IDM_OPEN mov ofn.lStructSize,SIZEOF ofn push hWnd pop ofn.hwndOwner push hInstance pop ofn.hInstance mov ofn.lpstrFilter, OFFSET FilterString mov ofn.lpstrFile, OFFSET buffer mov ofn.nMaxFile,MAXSIZE mov ofn.Flags, OFN_FILEMUSTEXIST or \ OFN_PATHMUSTEXIST or OFN_LONGNAMES or\ OFN_EXPLORER or OFN_HIDEREADONLY mov ofn.lpstrTitle, OFFSET OurTitle invoke GetOpenFileName, ADDR ofn .if eax==TRUE invoke lstrcat,offset OutputString,OFFSET FullPathName invoke lstrcat,offset OutputString,ofn.lpstrFile invoke lstrcat,offset OutputString,offset CrLf invoke lstrcat,offset OutputString,offset FullName mov eax,ofn.lpstrFile push ebx xor ebx,ebx mov bx,ofn.nFileOffset add eax,ebx pop ebx invoke lstrcat,offset OutputString,eax invoke lstrcat,offset OutputString,offset CrLf invoke lstrcat,offset OutputString,offset ExtensionName mov eax,ofn.lpstrFile push ebx xor ebx,ebx mov bx,ofn.nFileExtension add eax,ebx pop ebx invoke lstrcat,offset OutputString,eax invoke MessageBox,hWnd,OFFSET OutputString,ADDR AppName,MB_OK invoke RtlZeroMemory,offset OutputString,OUTPUTSIZE .endif .else invoke DestroyWindow, hWnd .endif .ELSE invoke DefWindowProc,hWnd,uMsg,wParam,lParam ret .ENDIF xor eax,eax ret WndProc endp end start

Analyse:

mov ofn.lStructSize,SIZEOF ofn push hWnd pop ofn.hwndOwner push hInstance pop ofn.hInstance

Wir füllen in der Routine Element der ofn-Struktur.

           mov ofn.lpstrFilter, OFFSET FilterString

Dieser FilterString ist der Dateinamen-Filter, den wir wie folgt spezifizieren:

FilterString db "All Files",0,"*.*",0 db "Text Files",0,"*.txt",0,0

Beachten Sie, dass alle vier String nullterminiert sind. Der erste String ist die Beschreibung des folgenden Strings. Das aktuelle Pattern ist der gradzahlige Sting, in diesem Fall "*.*" und "*.txt". Wir können hier jeden Pattern spezifizieren, den wir wollen. Wir MÜSSEN eine extra Null hinter dem letzten Pattern plazieren um das Ende des String Filter zu markieren. Vergessen Sie das nicht, ansonsten benimmt sich ihre Dialog Box eigenartig.

mov ofn.lpstrFile, OFFSET buffer mov ofn.nMaxFile,MAXSIZE

Wir spezifizieren wo die Dialog Box den Dateinamen hintut, den der Benutzer ausgewählt hat. Beachten Sie, dass wir die Größe im nMaxFile-Element spezifizieren müssen. Später können wir den Dateinamen aus diesem Buffer wieder extrahieren.

mov ofn.Flags, OFN_FILEMUSTEXIST or \ OFN_PATHMUSTEXIST or OFN_LONGNAMES or\ OFN_EXPLORER or OFN_HIDEREADONLY

Die Flags spezifizieren die Charakteristika der Dialog Box.

OFN_FILEMUSTEXIST und das OFN_PATHMUSTEXIST Flag verlangen, dass der Dateiname und der Pfad, den der Benutzer in das Edit-Steruerelement eintippt existieren MÜSSEN.
OFN_LONGNAMES teilt der Dialog Box mit, dass lange Dateiname angezeigt werden.
OFN_EXPLORER spezifiziert, dass das Aussehen der Dialog Box Explorer-mäßig ist.
OFN_HIDEREADONLY versteckt die nur-lesen Checkbox in der Dialog Box.
Es gibt viel mehr Flags, die Sie benutzen können. Konsultieren Sie ihre Win32 API Referenz.

            mov ofn.lpstrTitle, OFFSET OurTitle

Spezifiziert den Titel der Dialog Box.

            invoke GetOpenFileName, ADDR ofn

Rufen Sie die GetOpenFileName-Funktion auf. Den Zeiger auf die ofn-Struktur übergeben Sie als Parameter.

Zu diesem Zeitpunkt, wird die Datei-öffnen-Dialog-Box auf dem Bildschirm angezeigt. Die Funktion wird solange nicht zurückkehren, bis der Benutzer eine Datei zum öffnen anwählt oder den Abbrechen-Button anklickt oder die Dialog Box schließt.

Sie wird TRUE in EAX zurückliefern, wenn der Benutzer eine Datei zum öffnen ausgewählt hat. Ansonsten wird FALSE zurückgeliefert.

.if eax==TRUE invoke lstrcat,offset OutputString,OFFSET FullPathName invoke lstrcat,offset OutputString,ofn.lpstrFile invoke lstrcat,offset OutputString,offset CrLf invoke lstrcat,offset OutputString,offset FullName

Für den Fall, dass der Benutzer eine Datei zum öffnen ausgewählt hat, bereiten wir einen Ausgabe-String vor, der in einer Message-Box angezeigt wird. Wir alloziieren einen SpeicherBlock in der OutputString-Variable und benutzen dann die API Funktion lstrcat um die Strings miteinander zu verbinden. Um die Strings in verschriedene Zeilen zu schreiben, müssen wir jede Zeile mit einem Carriage Return-Zeilenvorschub Paar seperieren.

mov eax,ofn.lpstrFile push ebx xor ebx,ebx mov bx,ofn.nFileOffset add eax,ebx pop ebx invoke lstrcat,offset OutputString,eax

Die oberen Zeilen benötigen einige Erklärungen. nFileOffset enthält den Index auf ofn.lpstrFile. Aber Sie können sie nicht direkt zusammenfügen, da nFileOffset eine WORD-Variable und lpstrFile eine DWORD-Variable ist. Deswegen muss ich den Wert von nFileOffset in das untere Word von EBX speichern und ihn zum Wert von lpstrFile addieren.

                invoke MessageBox,hWnd,OFFSET OutputString,ADDR AppName,MB_OK

Wir zeigen den String in einer Message Box an.

                invoke RtlZerolMemory,offset OutputString,OUTPUTSIZE

Wir müssen den OutputString *löschen* bevor wir sie mit einem weiteren String füllen können. Deswegen benutzen wir die RtlZeroMemory-Funktion um das zu erledigen.

Deutsche Übersetzung: Joachim Rohde
Die original Win32Asm-Tutorials stammen von Iczelion's Win32 Assembly HomePage

lStructSize	Die Größe der OPENFILENAME Struktur , in Bytes
hwndOwner	Das Fenster-Handle der Datei-öffnen Dialog Box.
hInstance	Instanz Handle der Applikation, die die Datei-öffnen Dialog Box erzeugt.
lpstrFilter	Die Filter-Strings im Format gepaarter nullterminierter Strings. Der erste String in jedem Paar ist die Beschreibung. Der zweite String ist das Filter-Pattern. Zum Beispiel: FilterString db "Alle Dateien (.)",0, ".",0 db "Text Dateien (.txt)",0,".txt",0,0 Beachten Sie, dass nur das Pattern im zweiten String in jedem Paar von Windows wirklich benutzt wird, um Dateien auszufiltern. Beachten Sie auch, dass Sie eine extra 0 am Ende der Filter-Strings plazieren müssen, um das Ende zu kennzeichnen.
nFilterIndex	Spezifiziert welches Paar der Filter-Strings zur Initialisierung benutzt wird, wenn der Datei-öffnen Dialog das erste Mal angezeigt wird. Der Index beginnt bei 1, das heißt, dass erste Paar ist 1, das zweite Paar ist 2, usw. In dem obigen Beispiel, würde, wenn wir nFilterIndex gleich 2 setzen, das zweite Pattern benutzt werden, also "*.txt".
lpstrFile	Zeiger auf den Buffer, der den Dateinamen enthält, welcher benutzt wird um das Dateiname-Edit-Steuerelement zu initialisieren. Der Buffer sollte mindestens 260 Bytes groß sein. Nachdem der Benutzer eine Datei zum öffnen ausgewählt hat, wird der Dateiname mit dem kompletten Pfad in diesem Buffer gespeichert. Sie können die Informationen später hieraus extrahieren.
nMaxFile	Die Größe des lpstrFile Buffer.
lpstrTitle	Zeiger auf den Titel der Datei-Öffnen Dialog Box.
Flags	Bestimmt die Stile und Charakteristika der Dialog Box.
nFileOffset	Nachdem der Benutzer eine Datei zum Öffnen ausgewählt hat, enthält dieses Element den Index des ersten Buchstabens, des aktuellen Dateinnamen. Wenn der volle Name zum Beispiel "c:\windows\system\lz32.dll lautet, dann enthält dieses Element den Wert 18.
nFileExtension	Nachdem der Benutzer eine Datei zum Öffnen ausgewählt hat, enthält dieses Element den Index des ersten Buchstabens, der Datei-Extension.