CurrentTitle (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

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

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

Title of dialog boxes
Title of clipped windows
Title presentation
Equivalence
Minimized window

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

CurrentTitle (Function)

In french: TitreEnCours

Sets the title of the current window (returned by CurrentWin).

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

Example

// Remplacer le titre de la fenêtre en cours
CurrentTitle(gBackground(LightRed) + gPen(Black) + "Modification d'une fiche client")

// Modifier le titre de la fenêtre en cours
// Ajoute "en cours"
CurrentTitle(EOT + gBackground(LightRed) + gPen(Black) + " en cours")

Syntax

CurrentTitle(<New window title>)

<New window title>: Character string

New title for the current window.
If the EOT constant is specified, the new title will be added to the existing title.
In this string, you can use gBackground to change the background color, gPen to change the text color, etc. For more details, see the remarks.

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 change the title of the next window to open, use NextTitle.

Title of clipped windows

CurrentTitle can also be used to change the title of clipped windows. However, this title is not displayed in the window.

If a clipped skin template was used, the title of the window is displayed in a Static Text control. The content of this control is ignored by CurrentTitle. It must be modified specifically.

Title presentation

The graphic string 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 change the text color and background color of a title:

CurrentTitle(EOT + gBackground(RGB(0, 255, 255)) + gPen(RGB(255, 0, 0)) + "Test de couleur")

Special case under Windows Vista and 7 Windows using the "Aero system" look 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 the Title property:

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.

Business / UI classification: UI Code

Component: wd300obj.dll