CurrentTitle (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help

WLanguage

WLanguage functions

Controls, pages and windows

Window management functions

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

This content has been translated automatically. Click here to view the French version.

Title of dialog boxes
Presentation of title
Equivalence
Minimized window
Title display

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 Android applications.

New in version 15

This function is now available for Android applications.

Versions 17 and later

This function is now available for iPhone/iPad applications.

New in version 17

This function is now available for 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),
a 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 graphic strings management functions (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: Windows that use 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

Minimized window

When a window is minimized, the title of this window is displayed beside the icon in the taskbar.

Title display

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

Business / UI classification: UI Code

Component: wd260obj.dll