Set Cursor VI

Owning Palette: Cursor VIs

Requires: Base Development System

Changes the appearance of the cursor on the front panel of a VI. Wire data to the icon input to determine the polymorphic instance to use or manually select the instance.

(Real-Time Module) You cannot use this VI in VIs that run on RT targets.

Example

Use the pull-down menu to select an instance of this VI.

 Add to the block diagram  Find on the palette

Set Cursor (Icon Pict)

icon is the system or LabVIEW cursor you want to use on the front panel of the VI.

0Uses the default LabVIEW cursor. For example, if automatic tool selection is enabled and you move the cursor over a ring control, LabVIEW uses the cursor of the Operating tool. If you move the cursor over a string control, LabVIEW uses the cursor of the Labeling tool.
1 (Windows) LabVIEW uses this system cursor. (macOS and Linux) LabVIEW uses the system cursor that corresponds to this Windows cursor.
2 (Windows) LabVIEW uses this system cursor. (macOS and Linux) LabVIEW uses the system cursor that corresponds to this Windows cursor.
3 (Windows) LabVIEW uses this system cursor. (macOS and Linux) LabVIEW uses the system cursor that corresponds to this Windows cursor.
4 (Windows) LabVIEW uses this system cursor. (macOS and Linux) LabVIEW uses the system cursor that corresponds to this Windows cursor.
5 (Windows) LabVIEW uses this system cursor. (macOS and Linux) LabVIEW uses the system cursor that corresponds to this Windows cursor.
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
VI reference is a reference to the VI for which you want to change the cursor. The default is a reference to the current VI. You can use the Open VI Reference function to obtain a reference to another VI.

This input is useful if multiple front panels are open, but you want to change the cursor in only one front panel. If the front panel of the VI for which you want to change the cursor is not open, this VI returns an error.
error in describes error conditions that occur before this node runs. This input provides standard error in functionality.
previous cursor ID is a reference to the cursor on the front panel before this VI ran. Wire this output to another instance of the Set Cursor VI to change the cursor back to the previous cursor.
error out contains error information. This output provides standard error out functionality.

Set Cursor (Cursor ID)

cursor ID is a reference to the cursor you want to use on the front panel of the VI. Use the Create Cursor From File VI to obtain a reference to a cursor.

If the cursor reference is invalid, LabVIEW changes the cursor to the default LabVIEW cursor and returns control of the cursor to LabVIEW.
VI reference is a reference to the VI for which you want to change the cursor. The default is a reference to the current VI. You can use the Open VI Reference function to obtain a reference to another VI.

This input is useful if multiple front panels are open, but you want to change the cursor in only one front panel. If the front panel of the VI for which you want to change the cursor is not open, this VI returns an error.
error in describes error conditions that occur before this node runs. This input provides standard error in functionality.
previous cursor ID is a reference to the cursor on the front panel before this VI ran. Wire this output to another instance of the Set Cursor VI to change the cursor back to the previous cursor.
error out contains error information. This output provides standard error out functionality.

Example

Refer to the Change Cursor Icon VI in the labview\examples\Dialog and User Interface\Cursor directory for an example of using the Set Cursor VI.

 Open example  Find related examples