rc.hlp (Table of Contents; Topic list)
Important Notice
The pages on this site contain documentation for very old MS-DOS software, purely for historical purposes. If you're looking for up-to-date documentation, particularly for programming, you should not rely on the information found here, as it will be woefully out of date.
POINTER (1.2)
                                                      Up Next Previous
────────────────────────────────────────────────────────────────────────────
 
 
                  The Resource Compiler POINTER Statement
 
POINTER pointer-id [load-option] [mem-option] filename
 
The POINTER statement defines a pointer resource for an application. A
pointer resource, typically created by using the MS OS/2 Icon Editor, is a
bitmap defining the shape of the mouse pointer on the screen. The POINTER
statement copies the pointer resource from the file specified in the
filename field and adds it to the application's other resources. A pointer
resource can be loaded from the executable file when needed by using the
WinLoadPointer function.
 
You can provide any number of POINTER statements in a resource-definition
file, but each statement must specify a unique pointer-id value.
 
Field        Description
────────────────────────────────────────────────────────────────────────────
 
pointer-id   Specifies the pointer-resource identifier. This value must be
             an integer in the range 0 through 65,535, or a simple
             expression that evaluates to a value in that range.
 
load-option  Specifies when the system loads the resource from the
             executable file into memory. This value must be one of the
             following:
 
             Value       Meaning
             ───────────────────────────────────────────────────────────────
             PRELOAD     System loads the resource when the application
                         starts.
 
             LOADONCALL  System loads the resource when the application
                         calls the WinLoadPointer function. This is the
                         default value.
 
mem-option   Specifies how the system manages the resource when it is in
             memory. This value must be one or more of the following:
 
             Value        Meaning
             ───────────────────────────────────────────────────────────────
             FIXED        System keeps the resource at a fixed memory
                          location.
 
             MOVEABLE     System moves the resource as necessary to compact
                          memory.
 
             DISCARDABLE  System discards the resource if it is no longer
                          needed.
 
             The default setting is MOVEABLE and DISCARDABLE.
 
filename     Specifies the name of the file containing the pointer resource.
             If the file is not in the current directory, filename must be
             preceded by a full path.
 
Example
 
This example defines a pointer whose pointer identifier is 10. The pointer
resource is copied from the file custom.cur.
 
POINTER 10 custom.cur
 
See Also
 
WinLoadPointer