Custom Item Symbols:Set To Custom Symbol Method

Short Name: Custom Item Symbols.Set Symbol

Requires: Base Development System

Class: ListBox Methods

To Use: Create a method.

Sets the image of an item symbol.

If you want to use a picture to set the symbol, use the Picture to Pixmap VI to convert the data to an image data cluster before using this method. The image cluster you wire to this method is similar to the image data input of the Write JPEG File, Write PNG File, and Write BMP File VIs.

Parameters

Data typeNameRequiredDescription
IndexYesThe index of the symbol you want to set. The default is 0. You also can wire a listbox symbol ring constant to this parameter to select the custom item symbol you want to replace with a default item symbol.
ImageYesDescribes the image you want to use for the item symbol. Images that are less than or equal to 16 × 16 pixels appear as their actual size. If you use an image that is larger than 16 × 16 pixels, LabVIEW shrinks the image to 16 × 16 pixels before displaying it as a listbox control item symbol.

Remarks

The following table lists the characteristics of this method.

Data typeNo return value
Available in Run-Time EngineYes (Read/Write)
Available in Real-Time Operating SystemYes
Settable when the VI is runningYes
Loads the front panel into memoryNo
Need to authenticate before useNo
Loads the block diagram into memoryNo
Remote access allowedYes