GetScreenTabFrame(TabName)

When a tab containing a Screen or Frame is created on PowerExplorer (please check the InsertScreenTab method), a Frame is created to contain that Screen, similar to what happens on an Elipse Power Viewer.

The GetScreenTabFrame method returns the tab's Frame indicated by the TabName parameter, or returns a script error if this tab does not exist or it does not have a Frame (this is the case for default tabs).

This Frame is only effectively created during the first activation of the tab. Therefore, if the tab is created but never activated, this method returns a script error.

Sub
  ' script to change a tab's Screen of PowerExplorer
  Set PEFrame = PE.GetScreenTabFrame("ChartTab")
  PEFrame.OpenScreen("ChartScreen2", 0)
End Sub

With the Frame object, users can use some methods as if they were executed on an Elipse Power Viewer. For example, users can use the OpenScreen method to open a new Screen on the Frame (that is, on the tab). The following methods of the Frame object cannot be used (they cause a script error):

•BringToFront

•Close

•MaximizeFrame

•MinimizeFrame

•MoveFrame

•RestoreFrame

•SetForegroundWnd

•SetFrameOptions