APPNOTE: PW0777: Palettes Self-Study Module

Last reviewed: December 2, 1996
Article ID: Q95411
The information in this article applies to:
  • 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 palettes.

To obtain this application note (PW0777), "Palettes Self-Study Guide," call Microsoft Technical Support.

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

Download PW0777.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 PW0777.EXE (size: 1025370 bytes) 
    
  • Internet (anonymous FTP)

          ftp ftp.microsoft.com
          Change to the \softlib\mslfiles directory
          Get PW0777.EXE (size: 1025370 bytes) 
    

MORE INFORMATION

     Microsoft(R) Technical Support Application Note (Text File)
                   PW0777: PALETTES SELF-STUDY MODULE
                                                   Revision Date: 4/94
                                                       1 Disk Included

The following information applies to Microsoft Windows SDK, version 3.1.

| 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) 1993-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. The course focuses on 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 supplied by engineers who provide developers with Windows programming support. The information included here has been determined by these specialists to be what 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:

  • Describe what palettes are and why it is beneficial to implement palette support in an application.
  • Explain the function of the data types, structures, and messages related to palette support.
  • Explain the concepts related to foreground and background palettes and realization.
  • Explain the concepts related to System Colors.
  • Explain the palette management techniques used to support animation.

INSTALLING THE SELF-STUDY MODULE

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

   PW0777

Next, unzip CLASS.EXE, a self-extracting file, and create the appropriate directory structure by using the "-d" switch as in the following command:

   class -d

Directory Structure

The directory structure that is created has a LABS subdirectory and a TRAINING subdirectory. The TRAINING subdirectory contains a help file for the self-study course, a compiled version of the sample code, and a .DLL (dynamic-link library) for the Print All feature. The LABS subdirectory contains 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; the student modifies this code to get the desired results. The DONECODE directory contains the code for the solutions to the lab.

Getting Started

Once you have successfully installed the self-study module, run Windows and bring up the File Manager. Go to the TRAINING subdirectory in the directory that you installed the self-study module in and double-click the PAL.HLP file. This will run the Windows Help engine and load the self-study module. You are now ready to begin the course.

Print All Feature

This self-study course has the option to "Print All" (a choice from the File menu). This menu selection prints the entire contents of the .HLP file containing the course.

   NOTE: 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.


Additional reference words: 3.10 softlib appnote PW0777
KBCategory: kbref kbprg kbappnote kbfile
KBSubcategory: GdiPal


THE INFORMATION PROVIDED IN THE MICROSOFT KNOWLEDGE BASE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND. MICROSOFT DISCLAIMS ALL WARRANTIES, EITHER EXPRESS OR IMPLIED, INCLUDING THE WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. IN NO EVENT SHALL MICROSOFT CORPORATION OR ITS SUPPLIERS BE LIABLE FOR ANY DAMAGES WHATSOEVER INCLUDING DIRECT, INDIRECT, INCIDENTAL, CONSEQUENTIAL, LOSS OF BUSINESS PROFITS OR SPECIAL DAMAGES, EVEN IF MICROSOFT CORPORATION OR ITS SUPPLIERS HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. SOME STATES DO NOT ALLOW THE EXCLUSION OR LIMITATION OF LIABILITY FOR CONSEQUENTIAL OR INCIDENTAL DAMAGES SO THE FOREGOING LIMITATION MAY NOT APPLY.

Last reviewed: December 2, 1996
© 1998 Microsoft Corporation. All rights reserved. Terms of Use.