SET WINDOW TITLE

version 6.0 (Modified)

SET WINDOW TITLE (title{; window})

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 User environment, 4th Dimension 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 Custom Menus environment, 4th Dimension does not change the titles of the windows.

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

Get window title.