A program or Workplace Shell object would call the following methods to get information about a data file object. These methods are not normally overridden.
┌──────────────────────────────┬──────────────────────────────┐ │Method Name │Description │ ├──────────────────────────────┼──────────────────────────────┤ │wpQueryAssociatedFileIcon │Returns the handle of the icon│ │ │for the WPProgram or │ │ │WPProgramFile object │ │ │associated with the data file │ │ │object. │ ├──────────────────────────────┼──────────────────────────────┤ │wpQueryAssociatedProgram │Returns the pointer to the │ │ │WPProgram or WPProgramFile │ │ │object associated with the │ │ │data file object. │ ├──────────────────────────────┼──────────────────────────────┤ │wpQueryPointerFromContents │Returns a pointer to shared │ │ │memory containing the contents│ │ │of the WPDataFile object. │ ├──────────────────────────────┼──────────────────────────────┤ │wpclsEnumClipboardClasses │Enumerates through all the │ │ │object classes that a │ │ │particular rendering mechanism│ │ │supports. │ └──────────────────────────────┴──────────────────────────────┘
A program or Workplace Shell object would call the following method to query information about a data file object. This method may be overridden to force the association of a specific icon with a data file.
┌──────────────────────────────┬──────────────────────────────┐ │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. │ └──────────────────────────────┴──────────────────────────────┘
A program or Workplace Shell object would call the following method to set information about a data file object. This method may be overridden to force the association of a specific icon with a data file.
┌──────────────────────────────┬──────────────────────────────┐ │Method Name │Description │ ├──────────────────────────────┼──────────────────────────────┤ │wpSetAssociatedFileIcon │Change the icon associated │ │ │with the data file object. │ ├──────────────────────────────┼──────────────────────────────┤ │wpSetContentsFromHandle │Sets a file's contents based │ │ │on a handle to a known system │ │ │data type. 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. │ ├──────────────────────────────┼──────────────────────────────┤ │wpSetContentsFromPointer │Sets a WPDataFile object's │ │ │contents based on a pointer to│ │ │shared memory. │ └──────────────────────────────┴──────────────────────────────┘
A program or Workplace Shell object would call the following method to render information about a data file object.
┌──────────────────────────────┬──────────────────────────────┐ │Method Name │Description │ ├──────────────────────────────┼──────────────────────────────┤ │wpRenderFromClipboard │Opens the clipboard and │ │ │retrieves the type of data │ │ │specified in the clipboard │ │ │format passed in, then writes │ │ │the clipboard data to a file. │ └──────────────────────────────┴──────────────────────────────┘
A program or Workplace Shell object would call the following method to add a clipboard association to a data file object.
┌──────────────────────────────┬──────────────────────────────┐ │Method Name │Description │ ├──────────────────────────────┼──────────────────────────────┤ │wpclsAddClipboardAssoc │Adds an association between a │ │ │clipboard format and a │ │ │particular class name. │ └──────────────────────────────┴──────────────────────────────┘