📄 app_two.html
字号:
<HTML><LINK HREF="style.css" REL="STYLESHEET" TYPE="text/css"><HEAD><TITLE>App Part 2: Using files and the common dialogs</TITLE></HEAD><BODY><FONT SIZE="-1">[ <A HREF="./index.html">contents</A>| <A HREF="http://www.winprog.org/">#winprog</A>]</FONT><HR><H1>App Part 2: Using files and the common dialogs</H1><P>Example: app_two</P><IMG SRC="images/app_two.jpg" ALT="[images/app_two.jpg]" ALIGN="right"><H2>The Common File Dialogs</H2><P>The first step to opening or saving files is finding out the filename to use... of course youcould always hard code the name of the file into your program, but honestly that doesn't makefor very useful programs most of the time.<P>Since this is such a common task, there are predefined system dialogs that you can use to allow the user to select a file name. The most common open and save file dialogs are accessedthrough <CODE>GetOpenFileName()</CODE> and <CODE>GetSaveFileName()</CODE> respectively, both of which take an <CODE>OPENFILENAME</CODE> struct.<PRE CLASS="SNIP"> OPENFILENAME ofn; char szFileName[MAX_PATH] = ""; ZeroMemory(&ofn, sizeof(ofn)); ofn.lStructSize = sizeof(ofn); // SEE NOTE BELOW ofn.hwndOwner = hwnd; ofn.lpstrFilter = "Text Files (*.txt)\0*.txt\0All Files (*.*)\0*.*\0"; ofn.lpstrFile = szFileName; ofn.nMaxFile = MAX_PATH; ofn.Flags = OFN_EXPLORER | OFN_FILEMUSTEXIST | OFN_HIDEREADONLY; ofn.lpstrDefExt = "txt"; if(GetOpenFileName(&ofn)) { // Do something usefull with the filename stored in szFileName }</PRE><P>Note that we call <CODE>ZeroMemory()</CODE> on the struct in order to initialise it to <CODE>0</CODE>.This is generally a wise practice, as some APIs are very picky about members that you don't use being set to<CODE>NULL</CODE>. This way you don't need to explicitely set each member that you don't use.<P>You can easily find out the meanings of the various members by looking them up in your documentation. The <CODE>lpstrFilter</CODE> value points to a double-NULL terminated string, and you can see from the examplethat there are several <CODE>"\0"</CODE> throughout it, including one at the end... the compiler will addthe second one at the end as it always does with string constants (that's what you generally don't need to put them in yourself). The <CODE>NULL</CODE>s in this string break it up into filters, each one is two parts. The first filterhas the description <CODE>"Text Files (*.txt)"</CODE>, the wildcard isn't required here I just put it in because I felt like it. The next part is the actual wildcard for the first filter, <CODE>"*.txt"</CODE>. We do the samething with the second filter except that this is a generic filter for all files. You can add as many different filtersas you'd like.<P>The <CODE>lpstrFile</CODE> points to the buffer we have allocated to store the name of the file, since filenames can'tbe larger than <CODE>MAX_PATH</CODE> this is the value that I've chosen for the buffer size.<P>The flags indicate that the dialog should only allow the user to enter filenames that already exist (since we want to openthem, not create them) and to hide the option to open the file in readonly mode, which we aren't going to support. Finallywe provide a default extention, so if the user types in <CODE>"foo"</CODE> and the file is not found, it will try to open <CODE>"foo.txt"</CODE> before finally giving up.<P>To select a file for saving instead of opening, the code is nearly the same, except for calling <CODE>GetSaveFileName()</CODE>we need only change the flags member to options more suitable for saving.<PRE CLASS="SNIP"> ofn.Flags = OFN_EXPLORER | OFN_PATHMUSTEXIST | OFN_HIDEREADONLY | OFN_OVERWRITEPROMPT;</PRE><P>In this case we no longer want to require the file exist, but we do want the directory to exist since we aren't goingto try and create it first. We'll also prompt the user if they select an existing file to make sure they want to overwrite it.<P><B>NOTE:</B> MSDN States the following for the <CODE>lStructSize</CODE> member:<DL><DT><B>lStructSize</B><DD>Specifies the length, in bytes, of the structure. <P><B>Windows NT 4.0:</B> In an application that is compiled with WINVER and _WIN32_WINNT >= 0x0500, use OPENFILENAME_SIZE_VERSION_400 for this member. <P><B>Windows 2000/XP:</B> Use sizeof (OPENFILENAME) for this parameter. </DL><P>Basically what this means is that as of Windows 2000 they added some members to this struct, and so it'ssize changed. If the code above doesn't work for you it's possibly because the size that your compiler usedand the size that your operating system (ie. Windows 98, Windows NT4) expected were different and so thecall failed. If this happens, try using <CODE>OPENFILENAME_SIZE_VERSION_400</CODE> instead of <CODE>sizeof(ofn)</CODE>.Thanks to people that pointed this out to me.<H2>Reading and Writing Files</H2><P>In windows you have a few options as to how you want to access files. Youcan use the old <CODE>io.h</CODE> <CODE>open()</CODE>/<CODE>read()</CODE>/<CODE>write()</CODE>, you can use <CODE>stdio.h</CODE> <CODE>fopen()</CODE>/<CODE>fread()</CODE>/<CODE>fwrite()</CODE>,and if you are in C++ use can use iostreams.<P>However in windows all of these method ultimately call the Win32 API functions, which are what I will use here. If you are already comfortable using file IO with another method it shouldbe fairly easy to pick up, or if you want simply use your method of choice to access files.<P>To open files, you can use <CODE>OpenFile()</CODE> or <CODE>CreateFile()</CODE>. MS recommends using only <CODE>CreateFile()</CODE> as <CODE>OpenFile()</CODE> is now "obsolete". <CODE>CreateFile()</CODE> is a much more versatile function and provides a great deal of controlover the way you open files.<H3>Reading</H3><P>Say for example you have allowed the user to select a file using GetOpenFileName()...<PRE CLASS="SNIP">BOOL LoadTextFileToEdit(HWND hEdit, LPCTSTR pszFileName){ HANDLE hFile; BOOL bSuccess = FALSE; hFile = CreateFile(pszFileName, GENERIC_READ, FILE_SHARE_READ, NULL, OPEN_EXISTING, 0, NULL); if(hFile != INVALID_HANDLE_VALUE) { DWORD dwFileSize; dwFileSize = GetFileSize(hFile, NULL); if(dwFileSize != 0xFFFFFFFF) { LPSTR pszFileText; pszFileText = GlobalAlloc(GPTR, dwFileSize + 1); if(pszFileText != NULL) { DWORD dwRead; if(ReadFile(hFile, pszFileText, dwFileSize, &dwRead, NULL)) { pszFileText[dwFileSize] = 0; // Add null terminator if(SetWindowText(hEdit, pszFileText)) bSuccess = TRUE; // It worked! } GlobalFree(pszFileText); } } CloseHandle(hFile); } return bSuccess;}</PRE><P>There is a complete function to read a text file into an edit control. Ittakes as paramters the handle to the edit control and the name of the fileto read in. This perticular function has a fair bit of error checking,file IO is one place where a lot of things can go wrong, and so you need tobe on the lookout for errors.<P><B>Note</B> the variable <CODE>dwRead</CODE>. We don't use it except as a paramter in <CODE>ReadFile()</CODE>.This parameter <I>MUST</I> be provided, the call will fail without it.<P>In the call to <CODE>CreateFile()</CODE> <CODE>GENERIC_READ</CODE> means we only want read access.<CODE>FILE_SHARE_READ</CODE> means it's okay if other programs open the file at thesame time we do, but ONLY if they want to read as well, we don't want themwriting to the file while we are reading it. And <CODE>OPEN_EXISTING</CODE> means onlyopen the file if it already exists, don't create it, and don't overwrite it.<P>Once we've opened the file and chacked to see that <CODE>CreateFile()</CODE> succeeded, we check thesize of the file so we'll know how much memory we need to allocate in order to read the entire thing.We then allocate the memory, check to make sure the allocation succeeded, and then call <CODE>ReadFile()</CODE>to load the contents from disk into our memory buffer. The API file functions have no concept of <I>Text Files</I>so they won't do things like read a single line of text, or add <CODE>NULL</CODE> terminators to the end of our strings. Thisis why we've allocated an extra byte and after we read in the file we add the <CODE>NULL</CODE> ourselves so that we can then pass the memory buffer as a string to <CODE>SetWindowText()</CODE>.<P>Once all that has succeeded we set out success variable to <CODE>TRUE</CODE>, and clean up as we reach the end of the function,freeing the memory buffer and closing the file handle before finally returning to the caller.<H3>Writing</H3><PRE CLASS="SNIP">BOOL SaveTextFileFromEdit(HWND hEdit, LPCTSTR pszFileName){ HANDLE hFile; BOOL bSuccess = FALSE; hFile = CreateFile(pszFileName, GENERIC_WRITE, 0, NULL, CREATE_ALWAYS, FILE_ATTRIBUTE_NORMAL, NULL); if(hFile != INVALID_HANDLE_VALUE) { DWORD dwTextLength; dwTextLength = GetWindowTextLength(hEdit); // No need to bother if there's no text. if(dwTextLength > 0) { LPSTR pszText; DWORD dwBufferSize = dwTextLength + 1; pszText = GlobalAlloc(GPTR, dwBufferSize); if(pszText != NULL) { if(GetWindowText(hEdit, pszText, dwBufferSize)) { DWORD dwWritten; if(WriteFile(hFile, pszText, dwTextLength, &dwWritten, NULL)) bSuccess = TRUE; } GlobalFree(pszText); } } CloseHandle(hFile); } return bSuccess;}</PRE><P>Very similar to reading files, the function to write files has a few changes. First of allwhen we call <CODE>CreateFile()</CODE> we specify that we want Read access, that the fileshould always be created new (and if it exists it will be erased as it's opened) and thatif it doesn't exist, it will be created with the normal file attributes.<P>Next we get the length of the memory buffer needed from the edit control, since this is the sourceof the data. Once we've allocated the memory, we request the string from the edit controlusing <CODE>GetWindowText()</CODE> and then write it to the file with <CODE>WriteFile()</CODE>.Again, like with <CODE>ReadFile()</CODE> the parameter that returns how much was actually written is required, even though we don't use it.<HR><FONT SIZE="-1">Copyright © 1998-2003, Brook Miles (<A HREF="mailto:forger(nospam)winprog.org">theForger</A>). All rights reserved.</FONT><SCRIPT language="JavaScript"><!-- var re = /\(nospam\)/ig; var str; for(i = 0;i < document.links.length;i++) { str = "" + document.links(i).href; if(str.search(re) != -1) document.links(i).href = str.replace(re, "@"); str = "" + document.links(i).innerHTML; if(str.search(re) != -1) document.links(i).innerHTML = str.replace(re, "@"); }--></SCRIPT></BODY></HTML>⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -