TabStatus (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

TabStatus (Function)

In french: OngletEtat

Returns the status of a dynamic tab pane (identified by its alias).

Example

// Retrieves the selected row from a Table control
nSubscript is int = TableSelect(TABLE_Customer)
IF nSubscript = -1 THEN
ToastDisplay("Select a customer in the Table control")
RETURN
END

// Gets the customer identifier
nCustomerNum is int = TABLE_Customer.CUSTOMERID

// Defines the pane alias
sAlias is string = gaaTab[nCustomerNum]

// Checks whether the customer form is not already opened
IF sAlias = "" _OR_ TabStatus(TAB_MyTab, sAlias) = paneNotFound THEN
// Opens the window in modification
gaaTab[nCustomerNum] = ...
TabOpen(TAB_MyTab, StringBuild("Customer form of: %1", ...
TABLE_Customer.Name[nSubscript]), IW_Form, nCustomerNum)
ELSE
ToastDisplay("Form already opened")
// Enables the pane
TAB_MyTab = sAlias
END

Syntax

<Result> = TabStatus(<Tab control> , <Alias>)

<Result>: Integer constant

Status of dynamic tab pane:
paneActive The tab pane exists and is attached to its tab.
paneFloating The tab pane exists and is detached.
paneNotFound The tab pane does not exist or has been closed.

<Tab control>: Control name

Name of Tab control to use.

<Alias>: Character string (with quotes)

Alias of the dynamic tab pane to use. This alias can be retrieved by:
the property ..Value.
the property ..Alias.
the function TabOpen.
If this parameter does not correspond to any dynamic pane, the function has not action and a non-fatal error occurs.

Component : wd260obj.dll