4D v14.3

SET WINDOW TITLE

Home

 
4D v14.3
SET WINDOW TITLE

SET WINDOW TITLE 


 

SET WINDOW TITLE ( title {; window} ) 
Parameter Type   Description
title  String in Window title
window  WinRef in Window reference number, or Frontmost window of current process, if omitted

The SET WINDOW TITLE command changes the title of the window whose reference number is passed in window to the text passed in title (max. length 80 characters).

If the window does not exist, SET WINDOW TITLE does nothing.

If you omit the window parameter, SET WINDOW TITLE changes the title of the frontmost window for the current process.

Note: In the Design environment, 4D changes the window titles automatically —i.e., “Entry for Table” when you perform data entry. If you change a window title, 4D will probably override it. On the other hand, in the Application environment, 4D does not change the titles of the windows.

Example  

While performing data entry in a form, you click on a button that executes a lengthy operation (i.e., browsing programmatically related records shown in a subform). You keep informed about the progress of the operation using the title of the current window:

  ` bAnalysis button Object Method
 Case of
    :(Form event=On Clicked)
  ` Save current window title in a local variable
       $vsCurTitle:=Get window title
  ` Start the lengthy operation
       FIRST RECORD([Invoice Line Items])
       For($vlRecord;1;Records in selection([Invoice Line Items]))
          DO SOMETHING
  ` Show progress information
          SET WINDOW TITLE("Processing Line Item #"+String($vlRecord))
       End for
  ` Restore original window title
       SET WINDOW TITLE($vsCurTitle)
 End case

 
PROPERTIES 

Product: 4D
Theme: Windows
Number: 213

 
HISTORY 

Modified: 4D v6

 
SEE ALSO 

Get window title

 
ARTICLE USAGE

4D Language Reference ( 4D v11 SQL Release 6)
4D Language Reference ( 4D v12.4)
4D Language Reference ( 4D v14 R2)
4D Language Reference ( 4D v14 R3)
4D Language Reference ( 4D v13.5)
4D Language Reference ( 4D v14.3)
4D Language Reference ( 4D v14 R4)