Text プロパティ (UltraNavigationBarLocation)

位置のフル パスを構築するために使用される文字列を取得または設定します。これは編集モードの時にコントロールの編集部分に、また前の位置のドロップダウン リストにも表示されます。

シンタックス

Visual Basic

'宣言
 
Public Property Text As String

C#

public string Text {get; set;}

例外

例外	解説
System.Exception	テキストが PathSeparator プロパティの値を含む時にスローされます。

解説

Text プロパティが明示的に設定されていないと、Infragistics.Shared.KeyedSubObjectBase.Key プロパティの値はナビゲーション パスを解析する時にその位置を識別するために使用されます。DisplayText プロパティが明示的に設定されると、その値はユーザー インターフェイスでこの位置を表す LocationTextButtonUIElement に表示されます。DisplayText が明示的に設定されていないと、Text プロパティの解決された値が表示されます。ナビゲーション パスがコントロールによって解析されると、ナビゲーション パスの一部分がこの位置を表すかどうかを決定する時、解決されたテキスト (どれが明示的に設定されるかによって Text プロパティと Key プロパティのいずれかの値) と DisplayText の両方が評価されます。

注: Text プロパティは PathSeparator を含む値に設定できません。含むと例外がスローされます。

注: Text プロパティを空の文字列に設定することは、IncludeTextInFullPath プロパティを False に設定することと機能的に同等です。つまり子孫の位置を識別するパスを解析する時にこの位置のテキストもその祖先のテキストも必要とされません。