Set Frame Title of Workscreen

picture_as_pdf

This is an old revision of the document!

A work-screen doesn't have a title and it doesn't know the layout of the application which means that it doesn't know if it will be shown as window (= internal frame) or embedded as simple panel or something else. The application handles the whole layout.

But it's possible to change the title of the window. You have different options:

• It's always possible to search the parent frame via getParent() in a loop
• Another solution will be the application class
  

  public void onShow() throws Throwable
  {
      IContainer con = ((ProjX)getApplication()).getContainer(this);
   
      if (con instanceof IInternalFrame)
      {
          ((IInternalFrame)con).setTitle("My workscreen title");
      }
  }

  If your application or workscreen manager doesn't use frames, nothing will happen.

• The recommended solution is using a DataSourceWorkScreen as super class of your work-screen. The DataSourceWorkScreen contains methods like setTitle. So it's super simple to call:
  

  setTitle("My workscreen title");

  The code behind this method is:
  

  ProjX projx = getApplication();
   
  String sNewTitle = pTitle;
   
  if (sNewTitle == null)
  {
      //null sets default title
      sNewTitle = projx.getTitle(this);
  }
   
  IContainer cont = projx.getContainer(this);
   
  if (cont == null)
  {
      sTempTitle = sNewTitle;
  }
  else
  {
      projx.getWorkScreenManager().setTitle(cont, sNewTitle);
   
      sTempTitle = null;
  }

  It supports setting the title before the screen was added.