Changing window titles of open documents

 

With single-page documents (whether single-layer or multilayer), the page label is always displayed first in the document window title bar. If the page contains an active edit layer, the edit layer's name may be displayed as well. (This is configurable with SetUIConfiguration.)

Title bars for pages:

image\pagetits.gif

To modify the window title of a single-page document:

1. Use the SetPageTitle transaction.

2. If an active edit layer label is displayed, you can change it with SetLayerTitle.

3. Save the document using Save, SavePage, or SaveLayer.

The new window title is displayed and saved.

Multipage documents can include the following information in window titles:

image\wintitls.gif

These are configurable using SetUIConfiguration. Of the possible pieces of information, the multipage label, page label, and active edit layer label can be changed for any open multipages.

To modify the window title of a multipage document:

1. To change the root multipage label, use the SetDocumentTitle transaction.

2. To change a page label, use the SetPageTitle transaction.

3. To change the active edit layer label, use the SetLayerTitle transaction.

4. Save the document using Save or SaveDocument.

The new window title is displayed and saved.

Remarks

If the document structure changes in a way that causes the root multipage to be embedded within another multipage, the multipage title will not be promoted. The new root multipage will instead be called Untitled.

We do not recommend that you use SetWindowTitle for changing the window titles. Changes made to the window title this way cannot be saved, and they are lost as soon as the window is refreshed by any viewing change or other modification.

See also