MultipleViewPattern.GetViewName(Int32) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
コントロール固有のビューの名前を取得します。
public:
System::String ^ GetViewName(int viewId);public string GetViewName (int viewId);member this.GetViewName : int -> stringPublic Function GetViewName (viewId As Integer) As Stringパラメーター
- viewId
- Int32
コントロール固有のビュー識別子。
戻り値
コントロール固有のビューの名前を表すローカライズされた文字列。
例外
viewId は、サポートされているビュー コレクションのメンバーではありません。
例
次の例では、現在のビューのコントロール固有の名前が、サポート MultipleViewPatternされているコントロールから取得されます。
///--------------------------------------------------------------------
/// <summary>
/// Gets the name of the current view of a target.
/// </summary>
/// <param name="multipleViewControl">
/// The current multiple view control.
/// </param>
/// <returns>
/// The current view name.
/// </returns>
///--------------------------------------------------------------------
private string ViewName(AutomationElement multipleViewControl)
{
if (multipleViewControl == null)
{
throw new ArgumentNullException(
"AutomationElement parameter must not be null.");
}
// Get a MultipleViewPattern from the current control.
MultipleViewPattern multipleViewPattern =
GetMultipleViewPattern(multipleViewControl);
if (multipleViewControl != null)
{
try
{
int viewID =
(int)multipleViewControl.GetCurrentPropertyValue(
MultipleViewPattern.CurrentViewProperty);
return multipleViewPattern.GetViewName(viewID);
}
catch (ArgumentException)
{
// TO DO: error handling
}
}
return null;
}
'/--------------------------------------------------------------------
'/ <summary>
'/ Gets the name of the current view of a target.
'/ </summary>
'/ <param name="multipleViewControl">
'/ The current multiple view control.
'/ </param>
'/ <returns>
'/ The current view name.
'/ </returns>
'/--------------------------------------------------------------------
Private Function ViewName( _
ByVal multipleViewControl As AutomationElement) As String
If multipleViewControl Is Nothing Then
Throw New ArgumentNullException( _
"AutomationElement parameter must not be null.")
End If
If Not (multipleViewControl Is Nothing) Then
Try
' Get a MultipleViewPattern from the current control.
Dim multipleViewPattern As MultipleViewPattern = _
GetMultipleViewPattern(multipleViewControl)
Dim viewID As Integer = _
DirectCast(multipleViewControl.GetCurrentPropertyValue( _
multipleViewPattern.CurrentViewProperty), Integer)
Return multipleViewPattern.GetViewName(viewID)
Catch exc As ArgumentException
' TO DO: error handling
End Try
End If
Return Nothing
End Function 'ViewName
注釈
ビュー識別子は、次を使用 GetSupportedViewsして取得できます。
ビュー識別子のコントロール固有のコレクションは、インスタンス間で同じです。
ビュー名は、テキスト読み上げ、点字、およびその他のアクセス可能なアプリケーションでの使用に適しています。