GetScreenTabFrame(TabName)

When a tab containing a Screen or Frame is created on the WaterExplorer object, using the InsertScreenTab method, a Frame is created to contain that Screen, similar to what happens on an Elipse Water Viewer.

This method returns the Frame of the tab indicated by the TabName parameter, or returns a script error if this tab does not exist or it does not have a Frame, in the case of default tabs.

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

Sub CommandButton_Click()
  'Script to change the Screen of a tab of a WaterExplorer object
  Set WE = Application.GetWaterExplorer("System1.Station1")
  Set WEFrame = WE.GetScreenTabFrame("ChartTab")
  WEFrame.OpenScreen("ChartScreen2", 0)
End Sub

With the Frame object, users can use some methods as if they were executed on an Elipse Water 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 because they cause a script error:

•BringToFront

•Close

•MaximizeFrame

•MinimizeFrame

•MoveFrame

•RestoreFrame

•SetForegroundWnd

•SetFrameOptions