A program or Workplace Shell object would call the following methods to get information about an object's icons. A Workplace Shell object would override these methods to define its icons.

ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÂÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿
³Method Name                   ³Description                   ³
ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´
³wpQueryHandleFromContents     ³Returns a handle to a known   ³
³                              ³system data type based on a   ³
³                              ³file's contents.  This is an  ³
³                              ³abstract method; subclasses   ³
³                              ³that describe files for which ³
³                              ³a system handle type exist    ³
³                              ³(such as WPIcon or WPBitmap)  ³
³                              ³should subclass this method.  ³
ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´
³wpQueryIconData               ³Returns the information that  ³
³                              ³defines the object's icon.    ³
³                              ³This overrides the class      ³
³                              ³default icon defined by       ³
³                              ³wpclsQueryIconData.           ³
ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´
³wpclsQueryIconData            ³Returns the information that  ³
³                              ³defines the class default     ³
³                              ³icon. This icon is associated ³
³                              ³with every object of this     ³
³                              ³class. This icon can be       ³
³                              ³changed for an individual     ³
³                              ³object if:                    ³
³                              ³                              ³
³                              ³o The object overrides        ³
³                              ³  wpQueryIconData.            ³
³                              ³o The wpSetIconData method    ³
³                              ³  is called.                  ³
³                              ³o The wpSetup method is called³
³                              ³  with the ICONFILE or        ³
³                              ³  ICONRESOURCE keyword, or if ³
³                              ³  the user edits the icon on  ³
³                              ³  the General page of the     ³
³                              ³  Settings notebook.          ³
³                              ³                              ³
³                              ³For a folder class, this is   ³
³                              ³the closed folder icon.       ³
ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´
³wpclsQueryIconDataN           ³Returns the information that  ³
³                              ³defines the nth class default ³
³                              ³animation icon.               ³
³                              ³                              ³
³                              ³Note:                         ³
³                              ³This method is available only ³
³                              ³for a folder class.  It       ³
³                              ³defines the default open      ³
³                              ³folder icon for all objects   ³
³                              ³of this class.  This icon can ³
³                              ³be changed for an individual  ³
³                              ³object if wpSetup is called   ³
³                              ³with the ICONNFILE or         ³
³                              ³ICONNRESOURCE keyword, or if  ³
³                              ³the user edits the animation  ³
³                              ³icon on General page 2 of the ³
³                              ³Settings notebook.            ³
ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÁÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ

A program or Workplace Shell object would call the following methods to get information about an object's icons. These methods are not normally overridden by the object.

ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÂÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿
³Method Name                   ³Description                   ³
ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´
³wpQueryIcon                   ³Returns the handle of the     ³
³                              ³object's icon.                ³
ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´
³wpclsQueryIcon                ³Returns the handle of the     ³
³                              ³class default icon. For a     ³
³                              ³folder class, this method     ³
³                              ³returns the handle of the     ³
³                              ³class' default closed folder  ³
³                              ³icon.                         ³
ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´
³wpclsQueryIconN               ³Returns the handle of the nth ³
³                              ³class default animation icon. ³
³                              ³This method is available only ³
³                              ³for a folder class. It returns³
³                              ³the handle of the class'      ³
³                              ³default open folder icon.     ³
ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÁÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ

A program or Workplace Shell object would call the following methods to change the icon for an object. These methods are not normally overridden by the object.

ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÂÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿
³Method Name                   ³Description                   ³
ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´
³wpSetIcon                     ³Sets the handle of the        ³
³                              ³object's icon. This handle is ³
³                              ³not saved in the persistent   ³
³                              ³data of the object, so it has ³
³                              ³effect until the object goes  ³
³                              ³dormant. This method affects  ³
³                              ³all open views of the object. ³
³                              ³For a folder object, wpSetIcon³
³                              ³affects the icon displayed:   ³
³                              ³                              ³
³                              ³o In the title bar.           ³
³                              ³o On the Toolbar.             ³
³                              ³o On the General page 1 of    ³
³                              ³  the Settings notebook.      ³
³                              ³o In all containers if the    ³
³                              ³  object is closed.           ³
³                              ³  If the object is open, all  ³
³                              ³  containers continue to show ³
³                              ³  the object's animation      ³
³                              ³  icon.                       ³
ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´
³wpSetIconData                 ³Sets the definition for the   ³
³                              ³object's icon. This icon      ³
³                              ³definition is saved with the  ³
³                              ³persistent data of the object.³
³                              ³It permanently changes the    ³
³                              ³object's icon. This method    ³
³                              ³automatically calls wpSetIcon ³
³                              ³to update the visual display  ³
³                              ³of the object's icon.         ³
ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´
³wpSetProgIcon                 ³Sets the visible icon         ³
³                              ³associated with the program   ³
³                              ³reference or program file     ³
³                              ³object. This method is        ³
³                              ³available only for a program  ³
³                              ³reference or program file     ³
³                              ³object.                       ³
ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´
³wpclsSetIcon                  ³Sets the handle of the default³
³                              ³class icon.                   ³
ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´
³wpclsSetIconData              ³Sets the definition of the    ³
³                              ³default class icon.           ³
ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÁÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ


[Back] [Next]