Description

Create an event array by filtering times from an original time array according to specified filtering method.

Syntax

[Visual Basic .NET]
Public Function CreateEventArrayFiltered( _ ByVal Name As String, _ ByVal Description As String _ ) As IAgCrdnEventArray

[Visual Basic .NET]

Public Function CreateEventArrayFiltered( _
   ByVal Name As String, _
   ByVal Description As String _
) As IAgCrdnEventArray

[C#]
public IAgCrdnEventArray CreateEventArrayFiltered( string Name, string Description );

[Managed C++]
public: IAgCrdnEventArray^ CreateEventArrayFiltered( String __gc ^ Name, String __gc ^ Description );

[Managed C++]

public: IAgCrdnEventArray^ CreateEventArrayFiltered(
   String __gc ^ Name, 
   String __gc ^ Description
);

[Java]
public IAgCrdnEventArray createEventArrayFiltered( String Name, String Description );

[Unmanaged C++]
public: HRESULT CreateEventArrayFiltered( BSTR Name, BSTR Description, IAgCrdnEventArray ** ReturnValue );

[Unmanaged C++]

public: HRESULT CreateEventArrayFiltered(
   BSTR Name, 
   BSTR Description, 
   IAgCrdnEventArray ** ReturnValue
);

Parameters

Name
Description

Remarks

Spaces and most punctuation ( except for "-_().") cannot be used as a part of a component name when creating new components via VGT API.

Example

Create and configure filtered event array.

[C#] Copy Code

IAgCrdnEventArray eventArray = provider.EventArrays.Factory.CreateEventArrayFiltered("MyEventArrayFiltered",  "MyDescription"); 

IAgCrdnEventArrayFiltered asFiltered = eventArray as IAgCrdnEventArrayFiltered; 

 

asFiltered.OriginalTimeArray = provider.EventArrays["EphemerisTimes"]; 

 

asFiltered.FilterType = AgECrdnEventArrayFilterType.eCrdnEventArrayFilterTypeSkipTimeStep; 

asFiltered.IncludeIntervalStopTimes = true; 

 

// Uses current Time unit preference, this code snippet assumes seconds. 

asFiltered.Step = 240; 

 

IAgCrdnFindTimesResult timeArrays = eventArray.FindTimes(); 

if (timeArrays.IsValid) 

{ 

    Console.WriteLine("Times"); 

    int numTimes = timeArrays.Times.GetLength(0); 

    for (int i = 0; i < numTimes; ++i) 

    { 

        Console.WriteLine(timeArrays.Times.GetValue(i)); 

    } 

 

    foreach (IAgCrdnInterval timeArray in timeArrays.Intervals) 

    { 

        Console.WriteLine("Start: " + timeArray.Start); 

        Console.WriteLine("Stop: " + timeArray.Stop); 

    } 

}