APPNOTE: PW0740: Common Dialogs Self-Study Module

• Microsoft Windows Software Development Kit (SDK) for Windows version 3.1

SUMMARY

This application note is a self-study module created by Microsoft Technical Support Worldwide Training to help software engineers develop expertise in Windows common dialog boxes.

To obtain this application note (PW0740), "Common Dialog Boxes Self- Study Guide," call Microsoft Technical Support.

This application note is also available in the Microsoft Software Library:

Download PW0740.EXE, a file archived using the PKware file-compression utility, from the Microsoft Software Library (MSL) on the following services:

• Microsoft Download Service (MSDL)

        Dial (206) 936-6735 to connect to MSDL
        Download PW0740.EXE (size: 220369 bytes) 
  

• Internet (anonymous FTP)

        ftp ftp.microsoft.com
        Change to the \SOFTLIB\MSLFILES directory
        Get PW0740.EXE (size: 220369 bytes) 
  

MORE INFORMATION

       Microsoft(R) Technical Support Application Note (Text File)
               PW0740: COMMON DIALOGS SELF-STUDY MODULE

                                                   Revision Date: 4/94
                                                       1 Disk Included

| INFORMATION PROVIDED IN THIS DOCUMENT AND ANY SOFTWARE THAT MAY     |
| ACCOMPANY THIS DOCUMENT (collectively referred to as an Application |
| Note) IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER      |
| EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE IMPLIED      |
| WARRANTIES OF MERCHANTABILITY AND/OR FITNESS FOR A PARTICULAR       |
| PURPOSE. The user assumes the entire risk as to the accuracy and    |
| the use of this Application Note. This Application Note may be      |
| copied and distributed subject to the following conditions:  1) All |
| text must be copied without modification and all pages must be      |
| included;  2) If software is included, all files on the disk(s)     |
| must be copied without modification (the MS-DOS(R)  utility         |
| diskcopy is appropriate for this purpose);  3) All components of    |
| this Application Note must be distributed together;  and  4) This   |
| Application Note may not be distributed for profit.                 |
|                                                                     |
| Copyright (C) 1992-1994 Microsoft Corporation. All Rights Reserved. |
| Microsoft and MS-DOS are registered trademarks and Windows is a     |
| trademark of Microsoft Corporation.                                 |
|---------------------------------------------------------------------|

ABOUT THIS COURSE

This self-study course is one of a series of courses developed by Microsoft Technical Support Worldwide Training to help software engineers develop expertise in areas of Windows that they have not previously explored. As a result, the course focuses on and highlights common programming errors, common troubleshooting scenarios, documentation errors, and Windows issues in addition to common application programming techniques. This course was designed, and the technical content was provided, by the engineers currently providing developers with Windows programming support. The information included here is what these specialists have determined, through experience, that you need to know about this topic in order to successfully implement it into your application.

WHAT YOU WILL LEARN

After completing this course, you will:

• be able to describe the common dialogs provided by Windows 3.1.
• be able to effectively use existing reference materials and samples to solve common dialog programming problems.
• be able to use direct calls to the common dialog API to correctly display and retrieve information from each common dialog.
• be able to customize the behavior and appearance of a common dialog through the use of hook functions and custom templates.
• be able to describe and answer the common customer questions related to common dialog programming issues.

INSTALLING THE SELF-STUDY MODULE

First, copy PW0740.EXE to the directory that the course is to be installed. Change to that directory and enter the following command:

   PW0740

   class -d

Getting Started

Once you have successfully installed the training, run Windows and bring up the File Manager. Go to the directory that you installed the training in, and double click on the COMMDLG.HLP file. This will run the Help Engine, and load the training module. You are now ready to begin the course.

Directory Structure

The directory structure that will be created will have a LABS subdirectory and a TRAINING subdirectory. The TRAINING subdirectory will contain a help file for the printing course, a compiled version of the sample code, and a .DLL for the Print All feature. The LABS subdirectory will contain a subdirectory for each of the labs used in this course. In each of the individual lab subdirectories, there is a DONECODE and a BASECODE subdirectory. The BASECODE subdirectory contains the code for the lab that the student needs to modify to get the desired results. The DONECODE directory contains the code for the solutions to the lab.

Print All Feature

This self-study course has the option to "Print All" (a choice from the file menu). This menu selection will print the entire contents of the .HLP file that contains the course. Due to design limitations of the help engine, there is no way to abort this feature and all hardware input will be disabled while printing all. In addition, you cannot "Print to file" using this feature, the print job *must* go directly to the printer.