Control (Variable type)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help / WLanguage / WLanguage functions / Controls, pages and windows / Control functions

Declaring a Control variable
Assigning a Control variable
Using a Control variable in a procedure
Optimizing the processes with indirection
Properties associated with a Control variable
Functions that use a Control variable

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

Control (Variable type)

In french: Champ

The Control type is used to define the characteristics of a control. This control can be dynamically created by ControlCreate or a control in a window or report.

Note: For more details on the declaration of this type of variable and the use of WLanguage properties, see Declaring a variable.

Example

Remarks

Declaring a Control variable

The following syntax is used to declare a Control variable:

<Variable name> is Control

Example:

c is Control

In the declaration of a variable of type Control, you can specify the type of control using the following syntax:

<Variable name> is Control <control type = <Control type>>

where <Control type> is the constant that corresponds to the type of control to be created (see below).

Example:

MyControl is Control <control type = typButton>

The following constants can be used to define the control type:


typActiveX	17	ActiveX control Not available.
typOrganizer	76	Organizer control
typScrollbar	18	Scrollbar control Not available.
typAttribute	41	Attribute of a Looper control
typSlidingBanner	122	Sliding Banner control
typNavigationBar	117	Navigation Bar control
typToolbar	22	Toolbar control Not available.
typToolbox	29	Sidebar control Not available.
typButton	4	Button control
New in version 2025 typSegmentedButton	148	Segmented Button control Not available.
typCalendar	47	Calendar control
typCaptcha	82	Captcha control
typMap	92	Map control
typCarousel	37	Carousel control Not available.
typStatusBarBox	40002	Cells of a status bar Not available.
typCell	50014	Cell control
typCellCSSGrid	147	Cell control in a CSS Grid control.
typNavigationBarCell	115	Cell control in a Navigation Bar control.
typCellLayout	127	Cell in a Layout control Not available.
typCelluleFlexBox	139	Cell of a FlexBox control.
typCellPageLayout	84	Cell control used for the Zoning layout.
typFormattedControl	50001	Formatted display control
typHTMLControl	50002	HTML control
typMenuControl	50007	Menu of a WEBDEV page
typContextMenuControl	141	Context menu in a WEBDEV page
typBreadcrumb	50011	Breadcrumb control
typClick	30001	Clickable Image control (Image control with the "This image is a clickable area" option). Not available.
typBarCode	26	Bar Code control Not available.
typColumn	56	Table column
typComboWE	10001	Editable Combo Box control
typComboNE	10002	Non-editable Combo Box control
typWebComponent	121	Web Component control
typConference	25	Conference control Not available.
typNativeContainer	125	Native Container control Not available.
typCube	38	Cube control Not available.
typDate	20002	Date Edit control
typLayout	126	Layout control Not available.
typDuration	20006	Duration Edit control
typDiagramEditor	130	Diagram Editor control Not available.
typCodeEditor	146	Code Editor control Not available.
typHtmlEditor	134	HTML Editor control Not available.
typImageEditor	124	Image Editor control Not available.
typMobileImageEditor	138	Mobile Image Editor control Not available.
typWin	1	Window Not available.
typInternalWindow	31	Internal Window Not available.
typWire	118	Wire control Not available.
typFlash	50008	Flash control
typFlex	48	Flex control
typFlexbox	139	Flexbox control Not available.
typShape	20	Shape/Drawing control
typGantt	110	Gantt Chart column (Table or TreeView Table control). Not available.
typChart	33	Chart control in a window or page
typGrp	58	Group of controls
typTime	20003	Time Edit control
typHTML	23	HTML static
typIFrame	50013	IFrame control
typImage	8	Image control
typCheckBox	5	Check Box control
typSwitch	132	Switch control
typProgressBar	10	Progress Bar control
typInfiniteProgressBar	113	Infinite Progress Bar control Not available.
typJava	50004	Java control
typKanban	140	Kanban control
typPDFReader		PDF Reader control Not available.
typStatic	3	Static Text control
typHTMLStatic	50006	HTML Static control
typLink	50005	Link control
typSocialLink	103	Social Network control
typHorizontalRule	50003	Line control
typList	7	List Box control
typListView	27	ListView control Not available.
typKanbanList	142	Kanban List control
typMapArea	50010	Clickable Image control
typControlTemplate	43	Control Template control.
typCurrency	20005	Currency Edit control
typMultimedia	39	Multimedia control Not available.
typRating	85	Rating control Not available.
typRepositionableNote	119	Repositionable Note control Not available.
typNum	20004	Numeric Edit control
typOle	15	OLE control Not available.
typTab	16	Tab control
typSwitchOption	133	Option of a Switch control
typMenuOption	40001	Menu option
typOrganizationChart	86	Organization Chart control Not available.
typPage	1	Page
typPeelingCorner	79	Peeling Corner control
typInternalPage	31	Internal page
typPanel	131	Dockable Panel control Not available.
typSlidingBannerPlane	123	Plane associated with a Sliding Banner control
typSiteMap	45	Site Map control
typScheduler	80	Scheduler
typPopup	90	Popup page
typSlider	12	Slider control
typRangeSlider	72	Range Slider
typRotativeSlider	13	Round Slider Not available.
typRangeSlider	72	Range Slider control Not available.
typPager	50009	Pager control
typRibbonGroup		Ribbon group Not available.
typRibbon	87	Ribbon control Not available.
typBreak		Break in a Looper control
typRadioButton	6	Radio Button control
typSplitter	28	Splitter control Not available.
typSilverlight	46	SilverLight control
typSpin	11	Spin control Not available.
typSuperControl	40	Supercontrol
typTable	9	Table control
typPivotTable	102	Pivot Table control Not available.
typDashboard	111	Dashboard control
typTreeviewTable	35	TreeView Table control
typSpreadsheet	114	Spreadsheet control Not available.
typText	20001	Text Edit control
typDrawer	34	Drawer control
typWordProcessing	120	Word Processing control Not available.
typTreeMap	74	TreeMap control Not available.
typTreeView	19	TreeView control
typUpload	73	Upload control
typVideo	78	Video control
typThumbnail	50012	Thumbnail control
typWebCam	24	Web Camera control
typXaml	36	Xaml control Not available.
typMultilineZone	97	Multiline Zone control Not available.
typLooper	30	Looper control
typLinearLooper	77	Linear Looper control
typRichTextArea	109	Text Area control

Note: To no longer associate a control with a variable of type Control, simply use VariableReset.

Assigning a Control variable

A Control variable can be used to handle:

a control in a window or in a report.

The assignment of a Control variable must be performed by the '<-' operator.

Examples:

// Assignment with an existing control
c is Control
c <- EDT_Edit1

// Assignment by using the indirection
// The variable references the EDT_EDIT2 control
c <- {"EDT_EDIT2"}

Caution: The '=' operator must not be used to assign a value to a variable of type Control. This operator is used to transfer the value of a control into another control of the same type. For example:

// Assignment with an existing control
c is Control
c <- EDT_Edit1

// Modify the value 
c = EDT_Edit3 // Equivalent code: EDT_Edit1.Value = EDT_Edit3.Value
c = "Text" // Equivalent code: EDT_Edit1.Value = "Text"

Note: To determine if a value has been assigned to a variable of type Control, use the Type property on the variable. Example:

PROCEDURE ValueAssignedToControlVariable(varControl is Control): boolean
// Check whether a control has been assigned to a variable of type Control 
sType is int
WHEN EXCEPTION IN
	sType = varControl..Type
DO
	RETURN False
END
RETURN True

Using a Control variable in a procedure

The Control type can be a parameter of a procedure.

Method 1: Syntax without the type of the control:

procedure code:

PROCEDURE MyProcedure(C is Control)
C = "It is " + TimeSys()

procedure call:
```
MyProcedure(EDT_Edit1)
```

In this case, the type of the control is not checked at compile time.

Method 2: Syntax with the type of the control:

procedure code:

PROCEDURE MyProcedure(C is Control <control type = typInputText>)
C = "It is " + TimeSys()

procedure call:
```
MyProcedure(EDT_Edit1)
```

Advantage: If the procedure call uses a control of an unexpected type, a compilation error is displayed: "The type of control passed as parameter is not compatible with the expected type."

Optimizing the processes with indirection

The Control type can be used to optimize the processes that use the indirections. You can write for example:

C is Control <-{s, indControl}
C.Width = 10
C.Height = 20

rather than the following code:

{s, indControl}..Width = 10
{s, indControl}..Height = 20

Properties associated with a Control variable

The Control type is used to manipulate all types of controls found in a window or in a report. The available properties depend on the type of control used.

For example, if a variable of type Control is used to manipulate an Edit control, all the Edit control WLanguage properties will be available for that variable. By specifying the type of control when declaring the Control variable, only the properties of that type will be suggested in the code editor.

To learn more about the properties of a control, go to the corresponding page and click "See also". For more details, see Window controls.

Functions that use a Control variable

All the WLanguage functions that manipulate the controls can be used on a Control variable. However, only the WLanguage functions corresponding to the type of control used will be available. By specifying the type of control when declaring the Control variable, only the functions of that type will be suggested in the code editor.

For example, if a variable of type Control is used to manipulate a Table control, all the TableXXX functions will be available for that variable.

New in SaaS
Note: ControlExist can be used on a variable of type Control to check for a given control.
Note: This feature is only available from WINDEV Suite SaaS 2025 - Update 3.
For more details, see Using new features exclusive to WINDEV Suite SaaS 2025.