The Results Object

All the results from the analysis of a frame are encapsulated within the Results object. These results are stored as part of the Frame object hierarchy and are accessed using the Results property of this object. Alternatively, this collection can be accessed directly from the Multiframe Application object via the Results property. The methods and properties of the Results object are summarised in the following tables.

Property	Type	Description
Application	Application	Read Only. Returns reference to the parent application.
Frame	Frame	Read Only. Returns a reference to the parent frame.
Linear	LinearResults	Read Only. Returns a reference to object storing linear results.
Modal	ModalResults	Read Only. Returns a reference to object storing modal results.
Nonlinear	NonlinearResults	Read Only. Returns a reference to object storing nonlinear results.

Method	Returns	Description
Case	ResultCase	Returns a reference to the ResultCase containing the results of the specified analysis and load case.
Solved	Boolean	Returns true if the results of a specified analysis have been computed for the specified load case.

Properties

The Results object has three properties that provide access to the results of linear, non-linear and modal analyses. Each of these sets of results is stored in separate objects as shown in the diagram below.

Each of the objects storing the results from the different types of analyses contains a collection of ResultCase objects. Each ResultCase object stores the results for a single load case or, in the case of the modal analysis, the results for a single mode shape.

Methods

The Case method of the Results object provides a means of obtaining the results for a particular analysis without having to navigate the object hierarchy. This method takes two parameters; the first is a variant parameter identifying the load case. For modal analyses, this parameter identifies the index of the mode shape. The second parameter in an enumerated value of type mfAnalysisType, that specifies the analysis for which the results are required. This method returns a reference to a ResultCase object containing the desired information.

Dim myResults As Multiframe.ResultCase

With myFrame.Results

'Get results for linear analysis of load case 3
Set myResults = .Case(3)

'Get modal results using Case method
Set myResults = .Case(3, mfAnalysisModal)

End With

The Results object provides another method to complement the Case method that determines if the results for a particular case have been computed by an analysis. The Solved method takes the same parameters as the Case method and returns a value of true if the specified analysis has been performed. The above example could be recoded as

Dim myResults As Multiframe.ResultCase

With myFrame.Results

'Get results for linear analysis of load case 3
If (.Solved(3)) then
    Set myResults = .Case(3)
End If

If (.Solved(3, mfAnalysisModal)) then
    'Get modal results using Case method
    Set myResults = .Case(3, mfAnalysisModal)
End If

End With