msos2.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.
PTRSHAPE (1.2)
                                                      Up Next Previous
────────────────────────────────────────────────────────────────────────────
 
#define INCL_MOU
 
typedef struct _PTRSHAPE {    /* moups */
    USHORT cb;
    USHORT col;
    USHORT row;
    USHORT colHot;
    USHORT rowHot;
} PTRSHAPE;
 
The PTRSHAPE structure contains information about the shape of the mouse.
 
Field   Description
────────────────────────────────────────────────────────────────────────────
 
cb      Specifies the length in bytes of the AND and XOR masks.
 
col     Specifies the width of each mask. For text mode, the width is given
        in character cells. For graphics mode, the width is given in pels.
        This value must be greater than or equal to 1.
 
row     Specifies the height of each mask. For text mode, the width is given
        in character cells. For graphics mode, the height is given in pels.
        This value must be greater than or equal to 1.
 
colHot  Specifies the horizontal offset from the upper-left corner of the
        pointer shape to the hot spot. For text mode, the offset is given in
        character cells. For graphics mode, the offset is given in pels.
 
rowHot  Specifies the vertical offset from the upper-left corner of the
        pointer shape to the hot spot. For text mode, the offset is given in
        character cells. For graphics mode, the offset is given in pels.
 
Comments
 
The cb field of this structure is always equal to the height times the width
(row * col). If the current video mode requires multiple bit planes, the
row and col fields specify the width and height of the first plane only, but
the function copies all bit planes to the specified buffer.
 
See Also
 
MouGetPtrShape, MouSetPtrShape