SetCtrlVal函式

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.

相關詞條

熱門詞條

聯絡我們