MultipleViewPattern.GetViewName Method (Int32)


The .NET API Reference documentation has a new home. Visit the .NET API Browser on to see the new experience.

Retrieves the name of a control-specific view.

Namespace:   System.Windows.Automation
Assembly:  UIAutomationClient (in UIAutomationClient.dll)

public string GetViewName(
	int viewId


Type: System.Int32

The control-specific view identifier.

Return Value

Type: System.String

A localized string representing the control-specific view name.

Exception Condition

viewId is not a member of the supported views collection.

View identifiers can be retrieved by using GetSupportedViews.

The control-specific collection of view identifiers is identical across instances.

View names are suitable for use in Text to Speech, Braille, and other accessible applications.

In the following example, the control-specific name of the current view is retrieved from a control that supports 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 =

    if (multipleViewControl != null)
            int viewID = 
            return multipleViewPattern.GetViewName(viewID);
        catch (ArgumentException)
            // TO DO: error handling
    return null;

.NET Framework
Available since 3.0
Return to top