'宣言 Public Property DropDownButtonVisible As DropDownButtonVisible
public DropDownButtonVisible DropDownButtonVisible {get; set;}
例外 | 解説 |
---|---|
System.NotSupportedException | RootLocation のためこのプロパティに「Always」以外の値を設定するときにスローされます。 |
デフォルトで、ドロップダウン ボタンは、その Locations コレクションがひとつ以上の表示メンバーを含む時に限り、UltraNavigationBarLocation に表示されます。このルールの例外は RootLocation で、これは常にドロップダウン ボタンを表示します。DropDownButtonVisible プロパティを 'Never' に設定することでドロップダウン ボタンを表示しない、または 'Always' に設定することで子を持っているかどうかにかかわらずボタンを強制的に表示することができます。子の位置のドロップダウン リスト以外の何かを表示することが望ましい場合、後者の設定が役に立ちます。このシナリオで、開発者は LocationExpanding イベントを処理して、そのイベント引数の 'Cancel' プロパティを True に設定し(デフォルトのドロップダウン リストが表示しないようにする)、代替えのリスト、カスタム フォーム、またはコントロールなどを表示します。
注: UltraNavigationBar コントロールは、UltraNavigationBar.InitializeLocations イベントを介して、Locations コレクションを動的に移植することができるメカニズムを提供します。Locations コレクションに初めてアクセスする時、このイベントが発生しますが、オブジェクトのライフタイムの間に再度発生しません (NavigationBarLocationsCollection.Reset メソッドが呼び出されない限り)。