Class
RadDropDownButtonAutomationPeer

Provides the UI automation peer for the RadDropDownButton control, enabling accessibility support and interaction with automation clients. This class extends RadButtonAutomationPeer and implements the IExpandCollapseProvider interface, which provides methods to expand and collapse the drop-down content associated with the RadDropDownButton. It controls the state reporting of the drop-down button, handles invocation to toggle the drop-down, and retrieves automation properties such as the control's name and help text. Additionally, it supports the retrieval of child automation peers for any content displayed in the drop-down.

Definition

Namespace:Telerik.Windows.Automation.Peers

Assembly:Telerik.Windows.Controls.dll

Syntax:

cs-api-definition
public class RadDropDownButtonAutomationPeer : RadButtonAutomationPeer, IExpandCollapseProvider

Inheritance: objectRadButtonAutomationPeerRadDropDownButtonAutomationPeer

Derived Classes: RadGeometryDropDownButtonAutomationPeerRibbonDropDownButtonAutomationPeer

Implements: IExpandCollapseProvider

Inherited Members RadButtonAutomationPeer.GetAutomationControlTypeCore()

Constructors

RadDropDownButtonAutomationPeer(RadDropDownButton)

Initializes a new instance of the RadDropDownButtonAutomationPeer class.

Declaration

cs-api-definition
public RadDropDownButtonAutomationPeer(RadDropDownButton owner)

Parameters

owner

RadDropDownButton

The owner.

Properties

ExpandCollapseState

Gets the state (expanded or collapsed) of the control.

Declaration

cs-api-definition
public ExpandCollapseState ExpandCollapseState { get; }

Property Value

ExpandCollapseState

The state (expanded or collapsed) of the control.

Methods

Collapse()

Hides all nodes, controls, or content that are descendants of the control.

Declaration

cs-api-definition
public void Collapse()

Expand()

Displays all child nodes, controls, or content of the control.

Declaration

cs-api-definition
public void Expand()

GetAutomationIdCore()

Returns the string that uniquely identifies the FrameworkElement that is associated with this . This method is called by .

Declaration

cs-api-definition
protected override string GetAutomationIdCore()

Returns

string

The automation identifier for the element associated with the , or Empty if there is no automation identifier.

Overrides RadButtonAutomationPeer.GetAutomationIdCore()

GetChildrenCore()

Returns the collection of child elements of the UIElement that is associated with this . This method is called by .

Declaration

cs-api-definition
[SuppressMessage("Microsoft.Design", "CA1002:DoNotExposeGenericLists", Justification = "This is an override of a built-in class, the return type cannot be changed.")]
protected override List<AutomationPeer> GetChildrenCore()

Returns

List<AutomationPeer>

A list of child AutomationPeer elements.

GetClassNameCore()

Returns the name of the UIElement that is associated with this . This method is called by .

Declaration

cs-api-definition
protected override string GetClassNameCore()

Returns

string

The name of the owner type that is associated with this . See Remarks.

Overrides RadButtonAutomationPeer.GetClassNameCore()

GetHelpTextCore()

Returns the string that describes the functionality of the FrameworkElement that is associated with this . This method is called by .

Declaration

cs-api-definition
protected override string GetHelpTextCore()

Returns

string

The help text, or Empty if there is no help text.

Overrides RadButtonAutomationPeer.GetHelpTextCore()

GetItemStatusCore()

Declaration

cs-api-definition
protected override string GetItemStatusCore()

Returns

string

Overrides RadButtonAutomationPeer.GetItemStatusCore()

GetNameCore()

Returns the text label of the FrameworkElement that is associated with this . This method is called by .

Declaration

cs-api-definition
protected override string GetNameCore()

Returns

string

The text label of the element that is associated with this automation peer.

Overrides RadButtonAutomationPeer.GetNameCore()

GetPattern(PatternInterface)

When overridden in a derived class, gets an object that supports the requested pattern, based on PatternInterface input and the peer's implementation of known patterns.

Declaration

cs-api-definition
public override object GetPattern(PatternInterface patternInterface)

Parameters

patternInterface

PatternInterface

A value from the PatternInterface enumeration.

Returns

object

The object that implements the pattern interface; null if this peer does not support this interface.

Overrides RadButtonAutomationPeer.GetPattern(PatternInterface)

Invoke()

Sends a request to activate a control and initiate its single, unambiguous action.

Declaration

cs-api-definition
public void Invoke()