CxFmsHistoryGridCtrl Methods

The CxFmsHistoryGridCtrl object contains the following methods:

Apply

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

Syntax

Apply(SessionPropertiesOnly As Boolean)

Parameters

Example

The following example applies settings when a button is pressed.

1
2
3
4
Sub ButtonTool_EventClick()
Dim This : Set This = ButtonTool
    FmsHistoryGrid.Apply
End Sub

Cancel

Cancels the current task. 

Syntax

Cancel()

Remarks

The following is the list of tasks that can be canceled with this method.

• Building or refreshing the FMS History Grid
• Updating the cache when a new column is added
• Saving edits
• Expanding a row

Example

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

1
2
3
4
Sub btnCancel_EventClick()
Dim This : Set This = btnCancel
    FmsHistoryGrid.Cancel
End Sub

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.

1
2
3
4
5
6
7
8
9
10
11
12
Sub ButtonTool1_EventClick()
Dim This : Set This = ButtonTool1
    Dim aryNodes
    aryNodes = FmsHistoryGrid.ChooserGetNodeSelection
     
    Dim i, strMsg
    For i = 0 To UBound(aryNodes)
        strMsg = strMsg & aryNodes(i) & Vbcr
    Next
     
    MsgBox strMsg
End Sub

ChooserSetNodeSelection

Sets the selection of one Node in the Node chooser.

Syntax

ChooserSetNodeSelection(Selections As Variant) As Boolean

Parameters

Example

The following example selects one Node in the Node chooser.

1
2
3
4
5
6
7
8
9
Sub ButtonTool1_EventClick()
Dim This : Set This = ButtonTool1
    Dim aryNodes
    Redim aryNodes(0)
     
    aryNodes(0) = "2540"
         
    FmsHistoryGrid.ChooserSetNodeSelection aryNodes
End Sub

Refresh

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

Syntax

Refresh()

Example

The following example refreshes the Fms History Grid when a button is pressed.

1
2
3
4
Sub ButtonTool1_EventClick()
Dim This : Set This = ButtonTool1
    FmsHistoryGrid.Refresh
End Sub

RetrieveNodes

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

Syntax

RetrieveNodes()

Remarks

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

Example

The following example retrieves Nodes when the View is initialized.

1
2
3
4
Sub TheView_EventInitialize()
Dim This : Set This = TheView
    FmsHistoryGrid.RetrieveNodes
End Sub

Save

Commits edits to the database.  This method has the same function as the Save button on the FMS History Grid control.

Syntax

Save()

Example

The following example commits edits when a button is pressed.

1
2
3
4
Sub ButtonTool1_EventClick()
Dim This : Set This = ButtonTool1
    FmsHistoryGrid.Save
End Sub