AGI STK Util 11 Send comments on this topic.
ConvertQuantityArray Method (IAgConversionUtility)
See Also  Example
DimensionName
FromUnit
ToUnit
QuantityValues





Description

Converts the specified quantity values from a given unit to another unit.

Syntax

[Visual Basic .NET]
Public Function ConvertQuantityArray( _
   ByVal DimensionName As String, _
   ByVal FromUnit As String, _
   ByVal ToUnit As String, _
   ByRef QuantityValues As System.Array _
) As System.Array

[C#]
public System.Array ConvertQuantityArray(
string DimensionName,
string FromUnit,
string ToUnit,
ref System.Array QuantityValues
);

[Managed C++]
public: System::Array ConvertQuantityArray(
String __gc ^ DimensionName,
String __gc ^ FromUnit,
String __gc ^ ToUnit,
System::Array ^^ QuantityValues
);

[Java]
public Object[] convertQuantityArray(
String DimensionName,
String FromUnit,
String ToUnit,
Object[] QuantityValues
);

[Unmanaged C++]
public: HRESULT ConvertQuantityArray(
BSTR DimensionName,
BSTR FromUnit,
BSTR ToUnit,
SAFEARRAY ** QuantityValues,
SAFEARRAY ** Array
);

Parameters

DimensionName
FromUnit
ToUnit
QuantityValues

Example

Convert mulitple quantities of the same unit to another unit
[C#] Copy Code
IAgConversionUtility converter = root.ConversionUtility; 
 
// ConvertQuantityArray expects a one dimensional array of values to be converted 
// An array of km/sec units 
Array kmsecUnits = new object[] 
                   { 
                       10023 
                   }; 
 
// Convert to mi/sec units 
// ConvertQuantityArray returns a one dimensional array of converted values 
Array misecUnits = converter.ConvertQuantityArray("Rate""km/sec""mi/sec"ref kmsecUnits); 
 

Convert mulitple quantities of the same unit to another unit
[Visual Basic .NET] Copy Code
Dim converter As IAgConversionUtility = root.ConversionUtility

' ConvertQuantityArray expects a one dimensional array of values to be converted
' An array of km/sec units
#If Not CSToJava Then
#Else
#End If
Dim kmsecUnits As Array = New Object() {100, 23}

' Convert to mi/sec units
' ConvertQuantityArray returns a one dimensional array of converted values
#If Not CSToJava Then
Dim misecUnits As Array = converter.ConvertQuantityArray("Rate", "km/sec", "mi/sec", kmsecUnits)
#Else
#End If

See Also

© 2016 Analytical Graphics, Inc. All Rights Reserved.

STK Programming Interface 11.0.1