Scripting > CxHmiFms > CxFmsConfigCtrl Object > CxFmsConfigCtrl Methods

CxFmsConfigCtrl Methods

The CxFmsConfigCtrl object contains the following methods:

Apply

Applies modified settings and builds the FMS Configuration control.  This method has the same function as the Apply button on the FMS Configuration control.

Syntax

Apply(SessionPropertiesOnly As Boolean)

Parameters

Parameter

Required

Description

SessionPropertiesOnly

No

If this parameter is set to True, only the properties SessionNodeTag, SessionBeginDate, and SessionEndDate will be applied.

Example

The following example applies settings when a button is pressed.

  

Sub ButtonTool_EventClick()

Dim This : Set This = ButtonTool

FmsConfig.Apply

End Sub

Back to top

Cancel

Cancels the current task. 

Syntax

Cancel()

Remarks

The following tasks can be canceled with this method.

Example

The following example cancels a task when a button is pressed.  This example is taken from FMS Config Ctrl.csf found in the APPS SCREXAMP folder.

  

Sub btnCancel_EventClick()

Dim This : Set This = btnCancel

FmsConfig.Cancel

End Sub

Back to top

ChooserGetNodeSelection

Returns the list of Nodes currently selected in the Node chooser.

Syntax

ChooserGetNodeSelection() As Variant

Example

The following example displays a message box showing the list of selected Nodes.

  

Sub ButtonTool1_EventClick()

Dim This : Set This = ButtonTool1

Dim aryNodes

aryNodes = FmsConfig.ChooserGetNodeSelection

 

Dim i, strMsg

For i = 0 To UBound(aryNodes)

strMsg = strMsg & aryNodes(i) & Vbcr

Next

 

MsgBox strMsg

End Sub

Back to top

ChooserSetNodeSelection

Sets the selection of one Node in the Node chooser.

Syntax

ChooserSetNodeSelection(Selections As Variant) As Boolean

Parameters

Parameter

Required

Description

Selections

Yes

The Node, in "Node ID" format, to select in the Node chooser.

Example

The following example selects one Node in the Node chooser.

  

Sub ButtonTool1_EventClick()

Dim This : Set This = ButtonTool1

Dim aryNodes

Redim aryNodes(0)

 

aryNodes(0) = "2540"

 

FmsConfig.ChooserSetNodeSelection aryNodes

End Sub

Back to top

Refresh

Refreshes the data in the FMS Configuration control.  This method has the same function as the Refresh button on the FMS Configuration control.

Syntax

Refresh()

Example

The following example refreshes the CygNet FMS Configuration control when a button is pressed.

  

Sub ButtonTool1_EventClick()

Dim This : Set This = ButtonTool1

FmsConfig.Refresh

End Sub

Back to top

RetrieveNodes

Populates the Node chooser’s list of Nodes.  This method has the same function as the RetrieveNodes button on the FMS Configuration control’s Node chooser.

Syntax

RetrieveNodes()

Remarks

When this method is called, the Node chooser is populated according to the ChooserSiteServiceSelection, ChooserGroupSelection, ChooserFilterString, and ChooserFilterType properties.

Example

The following example retrieves Nodes when the View is initialized.

  

Sub TheView_EventInitialize()

Dim This : Set This = TheView

FmsConfig.RetrieveNodes

End Sub

Back to top

Let us know how we can improve this topic.

CygNet at weatherford.com

© 2020 Weatherford. All rights reserved.