MousePointer Property

  • Article

Specifies the shape of the mouse pointer when you move the mouse over a particular part of an object at run time. Read/write at design time and run time.

You can use the MousePointer property to indicate changes in functionality as the mouse pointer passes over controls on a form or dialog box.

Object.MousePointer [= nType]

Return Value

  • nType
    Specifies a value representing the shape of the mouse pointer.

    Note

    When you set the MousePointer property using the Properties window, the drop-down list displays the setting names used in Visual FoxPro for Windows.

    The following table lists the values for nType.

    nType

    Description

    0

    Shape determined by the object. (Default)

    1

    Arrow.

    2

    Cross (cross-hair pointer).

    3

    I-beam.

    4

    Icon (small white square within a black square).

    5

    Size (four-pointed arrow pointing up, down, left, and right).

    6

    Size NE SW (double arrow pointing diagonally from bottom left to top right).

    7

    Size NS (double arrow pointing vertically up and down).

    8

    Size NW SE (double arrow pointing diagonally from bottom right to top left).

    9

    Size WE (double arrow pointing horizontally left and right).

    10

    Up arrow.

    11

    Hourglass or wristwatch.

    Tip

    To indicate that the user should wait for a process to finish, set the MousePointer property to 11.

    12

    No drop.

    13

    Hide pointer.

    14

    Arrow.

    > [!NOTE]
> <P>Not a valid property value for grids. If set for grids, returns the error, "Expression evaluated to an illegal value."</P>

    15

    Hand.

    > [!NOTE]
> <P>When running Visual FoxPro applications on Windows 2000 operating systems, an arrow appears instead of a hand.</P>

    16

    Down arrow.

    > [!TIP]
> <P>This setting is particularly useful if the parent column of a header overrides the default setting for the header's <STRONG>MousePointer</STRONG> property.</P>

    99

    Custom. Uses pointer specified in object's MouseIcon property.

    Remarks

    Applies To: CheckBox | Column | ComboBox | CommandButton | CommandGroup | Container Object | Control Object | EditBox | Form | Grid | Header | Image | Label | Line | ListBox | OLE Bound Control | OLE Container Control | OptionButton | OptionGroup | _SCREEN | Shape | Spinner | TextBox | ToolBar

    See Also

    Reference

    MouseMove Event

    MouseIcon Property

    Other Resources

    Properties (Visual FoxPro)