ArcObjects Library Reference

Navigate Scene to Bookmark3D Snippet

Re-orient the visual perspective of a Scene to a specified BookMark3D.

[C#]

/// <summary>
/// Re-orient the visual perspective of a Scene to a specified BookMark3D. 
/// </summary>
/// <param name="sceneBookmarks">An ISceneBookmarks interface, that is a collection of bookmarks.</param>
/// <param name="bookmarkName">A System.String that is the name a particular BookMark3D in the ISceneBooksmarks collecton.</param>
/// <param name="sceneViewer">An ISceneViewer interface.</param>
/// <remarks>Only if the named Bookmark3D is found in the collection of ISceneBookmarks is the visual perspective of the Scene changed. 
/// Note: This snippet code is only for bookmarks created in the global navigation mode. 
/// It will not work with bookmarks created in surface navigation mode.</remarks>
public void NavigateSceneToBookmark3D(ESRI.ArcGIS.Analyst3D.ISceneBookmarks sceneBookmarks, System.String bookmarkName, ESRI.ArcGIS.Analyst3D.ISceneViewer sceneViewer)
{

  //Get a bookmark corresponding to list and apply it to the SceneViewer
  ESRI.ArcGIS.esriSystem.IArray array=sceneBookmarks.Bookmarks;
  System.Int32 bookmarkIndex=0;
  System.Int32 i=array.Count;
  for (bookmarkIndex=0; bookmarkIndex < i; bookmarkIndex++)
  {
    ESRI.ArcGIS.Analyst3D.IBookmark3D bookmark3D=(ESRI.ArcGIS.Analyst3D.IBookmark3D)array.get_Element(bookmarkIndex); // Explicit Cast
    if (bookmark3D.Name == bookmarkName)
    {

      //Switch to new bookmark location
      bookmark3D.Apply(sceneViewer, false, 0);

      return;

    }
  }

}

[Visual Basic .NET]

''' <summary>
''' Re-orient the visual perspective of a Scene to a specified BookMark3D. 
''' </summary>
''' <param name="sceneBookmarks">An ISceneBookmarks interface, that is a collection of bookmarks.</param>
''' <param name="bookmarkName">A System.String that is the name a particular BookMark3D in the ISceneBooksmarks collecton.</param>
''' <param name="sceneViewer">An ISceneViewer interface.</param>
''' <remarks>Only if the named Bookmark3D is found in the collection of ISceneBookmarks is the visual perspective of the Scene changed. 
''' Note: This snippet code is only for bookmarks created in the global navigation mode. 
''' It will not work with bookmarks created in surface navigation mode.</remarks>
Public Sub NavigateSceneToBookmark3D(ByVal sceneBookmarks As ESRI.ArcGIS.Analyst3D.ISceneBookmarks, ByVal bookmarkName As System.String, ByVal sceneViewer As ESRI.ArcGIS.Analyst3D.ISceneViewer)

  'Get a bookmark corresponding to list and apply it to the SceneViewer
  Dim array As ESRI.ArcGIS.esriSystem.IArray=sceneBookmarks.Bookmarks
  Dim bookmarkIndex As System.Int32
  For bookmarkIndex=0 To array.Count - 1
    Dim bookmark3D As ESRI.ArcGIS.Analyst3D.IBookmark3D=CType(array.Element(bookmarkIndex), ESRI.ArcGIS.Analyst3D.IBookmark3D) 'Explicit Cast
    If bookmark3D.Name=bookmarkName Then

      'Switch to new bookmark location
      bookmark3D.Apply(sceneViewer, False, 0)

      Exit Sub

    End If
  Next

End Sub

Additional Requirements

The code in this document requires the following References added to the Visual Studio project:
ESRI.ArcGIS.3DAnalyst
ESRI.ArcGIS.Animation
ESRI.ArcGIS.System