SetCtrlVal函式是NI LabWindows/CVI開發環境中的函式，該函式可用於大多數控制項的值的顯示，是CVI中的常用函式，其功能為給控制項設定一個由你定義的值，該值的數據類型由控制項類型決定。
基本介紹
- 中文名：設定控制項值
- 外文名：SetCtrlVal
函式原型,作用,支持控制項,數據類型變化,返回值,
函式原型
int SetCtrlVal (int panelHandle, int controlID, ...);
panelHandle為控制項所在面板的句柄，controlID為控制項的常量名字，controlID的格式為[面板CONST NAME_控制項CONST NAME]，CONST NAME可以通過雙擊控制項查看和更改。
作用
Sets the value of a control to a value you specify.
給控制項設定一個你定義的值。
When you call SetCtrlVal on a list box or a ring control, SetCtrlVal sets the current list item to the first item that has the value you specify. To set the current list item through a zero-based index, use SetCtrlIndex.
當你使用list box控制項或者ring控制項調用SetCtrlVal函式時，SetCtrlVal將你要設定的當前項設為控制項的第一項。如果要設定當前項為一個基於0索引的自定義項，使用SetCtrlIndex函式。
When you call SetCtrlVal on a text box, SetCtrlVal appends value to the contents of the text box and scrolls the text box to display value. UseResetToBox to replace the contents of the text box with value.
當你使用text box控制項調用SetCtrlVal 時，SetCtrlVal把值附加到text box控制項的現有值中，然後滾動text box控制項以顯示值SetCtrlVal設定的值。在這種情況下，應該使用ResetToBox來替換text box控制項中的值，而不是SetCtrlVal。
支持控制項
你可以使用SetCtrlVal 對如下控制項進行操作：
binary switches,
color numerics,
LEDs,
list boxes,
numerics,
picture buttons,
picture rings,
radio buttons,
rings,
numeric slides,
ring slides,
strings,
text boxes,
text buttons,
text messages,
toggle buttons,
trees.
數據類型變化
不同控制項所對應的不同數據類型
| Control/控制項 | Data Type/數據類型 |
|---|---|
Binary switch control | Data type you specify |
Color numeric control | unsigned long int |
LED control | int |
List box control | Data type you specify |
Numeric control | Data type you specify |
Numeric slide control | Data type you specify |
Picture button control | int (picture toggle buttons only) |
Picture ring control | Data type you specify |
Radio button control | int |
Ring control | Data type you specify |
Ring slide control | Data type you specify |
String control | char [] |
Text box control | char [] |
Text button control | int |
Text message control | char [] |
Toggle button control | int |
Tree control | Data type you specify |
返回值
Name | Type | Description |
status | int | Return value indicating whether the function was successful. A negative number indicates that an error occurred. |
