新しい場所にナビゲート

フォームがロードする時にコレクションを完全にロードするか、エンド ユーザーがコレクションを参照する時に動的にロードするのいずれかによって、WinNavigationBar™ Locations を移植することができます。コレクションを完全にロードする時に、 NavigateTo メソッドを呼び出すことによってこれらの位置のひとつにプログラムでナビゲートすることができます。引数としてナビゲートする必要があるパスを渡すだけです。WinNavigationBar はパスを解析し、このパスに沿って各項目に一致する位置を検索します。WinNavigationBar が項目のひとつに対して一致する位置を見つけることができない場合、 NavigationPathParseError イベントを発生させます。解析が成功すると、 SelectedLocationChanging および SelectedLocationChanged イベントが順に発生します。

WinNavigationBar の Location を遅延移植することを決定した場合、NavigateTo メソッドに渡すパスに注意が必要です。そのパスが未だ存在していない場合があるからです。WinNavigationBar を遅延移植するための最も実用的な方法は、InitializeLocations イベントを使用することです。 InitializeLocations は、ユーザーが初めて個別の位置にアクセスする時に発生します。EventArgs.ParentLocation オブジェクトに基づき位置の子を移植することができます。WinNavigationBar の遅延移植についての詳細は、 「WinNavigationBar を遅延移植」を参照してください。

以下のコードは、"C:\Program Files" フォルダを表す位置にナビゲートします。

Visual Basic の場合：

C# の場合：