CurrentTitle (Function)

WINDEV, WEBDEV AND WINDEV MOBILE
ONLINE HELP

Version:

Home | Sign in | English

Help

WLanguage

WLanguage functions

Controls, pages and windows

Functions for managing windows

CurrentTitle

Presentation

Example

Title of dialog boxes

Presentation of title

Constants for managing the windows

Constants for object visibility

ExecuteRefreshUIParent

FullScreen

Functions for managing windows

RequestRefreshUIParent

WinGiveSuitableHeight

Title of dialog boxes
Presentation of title
Equivalence
Displaying the title

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

CurrentTitle (Function)

In french: TitreEnCours

Modifies the title of current window (returned by CurrentWin) and the title bar.

Reminder: By default, the window title is the one defined in the editor.

Versions 15 and later

This function is now available for the Android applications.

New in version 15

This function is now available for the Android applications.

Versions 17 and later

This function is now available for the iPhone/iPad applications.

New in version 17

This function is now available for the iPhone/iPad applications.

Versions 18 and later

This function is now available in Android Widget mode.

New in version 18

This function is now available in Android Widget mode.

Versions 21 and later

This function is now available in Universal Windows 10 App mode.

New in version 21

This function is now available in Universal Windows 10 App mode.

Example

// Replace the title of the current window
CurrentTitle(gBackground(LightRed) + gPen(Black) + "Modifying a customer form")

// Modify the title of the current window
// Adds "in progress"
CurrentTitle(EOT + gBackground(LightRed) + gPen(Black) + " in progress")

Syntax

Modifying the window title Hide the details

CurrentTitle(<New Window Title>)

<New Window Title>: Character string (with quotes)

New title for the current window.

Modifying the title and the title bar of the window Hide the details

CurrentTitle([<Background Color> [, <Text Color>, ]] <New Window Title>)

<Background Color>: Optional integer

Color used for the background of the title bar. This color can correspond to:
an RGB color (returned by RGB),
an HSL color (returned by HSL),
an preset color of WLanguage.

<Text Color>: Optional integer

Color used for the text displayed in the title bar. This color can correspond to:
an RGB color (returned by RGB),
an HSL color (returned by HSL),
a preset color of WLanguage.

<New Window Title>: Character string (with quotes)

New title for the current window. If the EOT constant is specified, the new title will be added to the existing title.

Remarks

Title of dialog boxes

The windows opened by Warning, Confirm, Dialog, Error, ErrorInfo, Info, OKCancel or YesNo have the same title as the previous window.

To modify the title of the next window to open, use NextTitle.

Presentation of title

The functions for handling graphic strings (starting with "g") are used to:

add drawings to the title,
modify the formatting of title (background color, text color, etc.) with gBackground and gPen.

For example: to modify the text color and the background color of title:

CurrentTitle(EOT + gBackground(RGB(0, 255, 255)) + gPen(RGB(255, 0, 0)) + "Color test")

Special case in Windows Vista and 7: The windows that is using the "Aero system" style cannot have a graphic title: the graphic part is ignored. If "Aero" is not enabled, the graphic title will be displayed as usual.

Equivalence

The following code:

CurrentTitle(<New Window Title>)

is equivalent to ..Title

MyWindow..Title = <New Window Title>

Displaying the title

To display a title, the window must include an Action Bar control.

Business / UI classification : UI Code

Component : wd250obj.dll