New to Telerik UI for WPF? Start a free 30-day trial

RadDropDownButtonAutomationPeer

Class

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:

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.

public RadDropDownButtonAutomationPeer(RadDropDownButton owner)

Parameters:ownerRadDropDownButton

The owner.

Properties

ExpandCollapseState

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

public ExpandCollapseState ExpandCollapseState { get; }

Property Value:

The state (expanded or collapsed) of the control.

Methods

Collapse()

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

public void Collapse()

Expand()

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

public void Expand()

GetAutomationIdCore()

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

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 .

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 .

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 .

protected override string GetHelpTextCore()

Returns:

string

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

Overrides: RadButtonAutomationPeer.GetHelpTextCore()

GetItemStatusCore()

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 .

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.

public override object GetPattern(PatternInterface patternInterface)

Parameters:patternInterfacePatternInterface

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.

public void Invoke()