## FacetCollection.Navigate

### Introduced

v3.0

### Description

Allows you to navigate through the facets of the associated geometry. This method returns one facet for each corresponding component in the collection. For example, if you have a FacetCollection containing 5 facets and you call this method with the direction set to siLastComponent, the returned collection will contain 5 instances of the last facet in the original FacetCollection.

### C# Syntax

    FacetCollection FacetCollection.Navigate( siNavigateComponentType in_siNavigate );

### Scripting Syntax

    oReturn = FacetCollection.Navigate( Navigation );

### Return Value

FacetCollection

### Parameters

Parameter | Type | Description
--- | --- | ---
Navigation | siNavigateComponentType | Select the direction of navigation.

### Examples

#### VBScript Example

    set oObj = ActiveSceneRoot.AddGeometry( "Cube", "MeshSurface" )
    set oSubComp = oObj.ActivePrimitive.Geometry.Facets(2).SubComponent
    oSubComp.AddElement(3)
    set oFacets = oSubComp.ComponentCollection
    set oFirstFacets = oFacets.Navigate(siFirstComponent)
    LogMessage "The associated first facets are "
    for each facet in oFirstFacets
    LogMessage facet.index & " "
    next
    set oLastFacets = oFacets.Navigate(siLastComponent)
    LogMessage "The associated last facets are "
    for each facet in oLastFacets
    LogMessage facet.index & " "
    next
    set oNextFacets = oFacets.Navigate(siNextComponent)
    LogMessage "The associated next facets are "
    for each facet in oNextFacets
    LogMessage facet.index & " "
    next
    set oPreviousFacets = oFacets.Navigate(siPreviousComponent)
    LogMessage "The associated previous facets are "
    for each facet in oPreviousFacets
    LogMessage facet.index & " "
    next

### See Also

Facet.Navigate Geometry.Facets SubComponent.AddElement SubComponent.ComponentCollection