- Naming tab panes
- Handling a tab pane
- Changing the active tab pane
- Identifying the active tab pane
- Tab pane number
- Tab pane text
- WLanguage functions for handling Tab controls
- Properties specific to the Tab controls
Handling a Tab control through programming
WINDEV, WINDEV Mobile and WEBDEV allow you to handle a Tab control through programming. To do so, use the variable of the Tab control in the code.
The variable of the Tab control corresponds to the number of the active pane. This variable is an integer. This number is assigned in the tab description: in the list of tabs, the first tab is tab #1, the second tab is tab #2, ...
You can also name the tab panes (in the "General" tab of the control description window). In this case, you can directly enter the tab name to manipulate it.
Remark: Going from a tab to another one (when the user clicks a tab) is automatically managed.
The different codes for handling the Tab controls are server codes.
From version 26, you can name tab panes. These (optional) names make it easier to manipulate tabs in the code. Unnamed tabs are handled via their index. If the index changes (when a tab is moved, inserted, etc.), all the WLanguage code must be revised to take this change into account.
Naming tabs makes these operations easier: the name of the tab pane is specified in the "General" tab of the control description window. It can then be used in the code to designate the pane to handle. You can move or insert tabs without having to check all the existing code.
To handle a tab pane via WLanguage properties, use the following syntax:
- Unnamed tab pane: the tab pane is identified by its number. The number is assigned in the tab description: in the list of tabs, the first tab is tab #1, the second tab is tab #2, ...
Name_Tab_Control[Number_Of_Tab_Pane].PropertyName = PropertyValue
TAB_MyTab.State = Grayed
- Named tab pane: The tab pane is identified by the name specified in the "General" tab of the control description window.
Name_Tab_Pane.PropertyName = PropertyValue
For example, if the tab pane is named "Search":
Remark: To use properties on a control, you can use <Control name>.PropertyName or
Changing the active tab pane
The tab pane #1 (the most on the left) is enabled by default. The current tab can be changed by programming.
To enable a tab pane:
- Unnamed tab pane: Assign the tab with the number of the tab pane to enable:
Name_Tab_Control = Number_Of_Tab_Pane
- Named tab pane: Assign the name of the tab pane to be enabled to the Tab control:
Name_Tab_Control = Tab_Pane_Name
- Use the Value property.
- If the specified tab pane does not exist, the displayed tab pane is not changed.
- On a single Tab control, only one tab pane can be displayed at a time.
- When changing tab pane:
- the exit code of the control with focus is run.
- the entry code of first editable control in the tab pane is enabled.
Identifying the active tab pane
Tab pane number
To get the number of the active tab pane:
- perform a simple assignment. For example:
NumActivePane = NameTabControl
- use the Value property.
Tab pane text
To get the text of the active tab pane, simply use the Caption
property on the tab pane:
- unnamed tab:
- unnamed tab:
property can also be used to change the text of the tab pane.
WLanguage functions for handling Tab controls
The following functions are used to manage the characteristics of a Tab control by programming.
Properties specific to the Tab controls
The following properties are used to manage the characteristics of a Tab control by programming.
|Image||Used to find out and modify the image associated with a tab pane or with a tab. |
To handle the tab pane, use the following syntax: <Tab control> [<Pane subscript>].
|Count||Used to find out the number of panes in a tab.|
To find out the entire list of WLanguage properties that can be used with a Tab control, see Properties associated with a Tab control
This page is also available for…