ValidatePanel
int ValidatePanel (int panelHandle, int *valid);
Purpose
Verifies that the value of each numeric control in notify mode is within the range specified in the User Interface Editor or set by SetCtrlAttribute using ATTR_MAX_VALUE and ATTR_MIN_VALUE.
If a control is out of range, a red outline appears around it prompting the user to enter a new value. When the control has the input focus, a pop-up dialog box appears indicating the range and default value of the control.
 |
Note LabWindows/CVI calls ValidatePanel when it is preparing to generate a commit event in response to user input on a control that is in Validate mode. LabWindows/CVI generates the commit event only if all controls are in range. |
Parameters
| Input | ||
| Name | Type | Description |
| panelHandle | int | Specifier for a particular panel that is currently in memory. You can obtain this handle from functions such as LoadPanel and NewPanel. |
| Output | ||
| Name | Type | Description |
| valid | int | Boolean value that indicates whether each control in VAL_NOTIFY mode is within its valid range. 0 = one or more controls are out of range 1 = all controls are in range |
Return Value
| Name | Type | Description |
| status | int | Return value indicating whether the function was successful. A negative number indicates that an error occurred. |
Additional Information
Library: User Interface Library
Include file: userint.h
LabWindows/CVI compatibility: LabWindows/CVI 3.0 and later