Class
RadCalendarAutomationPeer

This class is an implementation of the automation peer for the RadCalendar control. It enables UI Automation by exposing properties and patterns required for accessibility. This includes supporting multiple views, selection capabilities, and grid-like behavior for child elements. The class implements several automation provider interfaces such as IMultipleViewProvider, ISelectionProvider, ITableProvider, and IGridProvider to facilitate diverse automation functionalities including retrieving selected items, row and column counts, and navigation capabilities within the calendar control. In addition, it handles the management of view modes and localized control types, ensuring that appropriate names and values are provided for accessibility tools.

Definition

Namespace:Telerik.Windows.Automation.Peers

Assembly:Telerik.Windows.Controls.Input.dll

Syntax:

cs-api-definition
public class RadCalendarAutomationPeer : FrameworkElementAutomationPeer, IMultipleViewProvider, ISelectionProvider, ITableProvider, IGridProvider

Inheritance: objectRadCalendarAutomationPeer

Implements: IGridProviderIMultipleViewProviderISelectionProviderITableProvider

Constructors

RadCalendarAutomationPeer(RadCalendar)

Initializes a new instance of the RadCalendarAutomationPeer class.

Declaration

cs-api-definition
public RadCalendarAutomationPeer(RadCalendar owner)

Parameters

owner

RadCalendar

The owner.

Properties

CanSelectMultiple

Gets a value that specifies whether the UI Automation provider allows more than one child element to be selected concurrently.

Declaration

cs-api-definition
public bool CanSelectMultiple { get; }

Property Value

bool

true if multiple selection is allowed; otherwise false.

ColumnCount

Gets the total number of columns in a grid.

Declaration

cs-api-definition
public int ColumnCount { get; }

Property Value

int

The total number of columns in a grid.

CurrentView

Gets the current control-specific view.

Declaration

cs-api-definition
public int CurrentView { get; }

Property Value

int

The value for the current view of the UI Automation element.

IsSelectionRequired

Gets a value that specifies whether the UI Automation provider requires at least one child element to be selected.

Declaration

cs-api-definition
public bool IsSelectionRequired { get; }

Property Value

bool

true if selection is required; otherwise false.

RowCount

Gets the total number of rows in a grid.

Declaration

cs-api-definition
public int RowCount { get; }

Property Value

int

The total number of rows in a grid.

RowOrColumnMajor

Retrieves the primary direction of traversal for the table.

Declaration

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

Property Value

RowOrColumnMajor

The primary direction of traversal.

Methods

GetAutomationControlTypeCore()

Gets the control type for the UIElement that is associated with this . This method is called by .

Declaration

cs-api-definition
protected override AutomationControlType GetAutomationControlTypeCore()

Returns

AutomationControlType

The enumeration value.

GetChildrenCore()

Gets 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")]
protected override List<AutomationPeer> GetChildrenCore()

Returns

List<AutomationPeer>

A list of child AutomationPeer elements.

GetClassNameCore()

Declaration

cs-api-definition
protected override string GetClassNameCore()

Returns

string

GetColumnHeaders()

Gets a collection of UI Automation providers that represents all the column headers in a table.

Declaration

cs-api-definition
public IRawElementProviderSimple[] GetColumnHeaders()

Returns

IRawElementProviderSimple[]

A collection of UI Automation providers.

GetHelpTextCore()

Declaration

cs-api-definition
protected override string GetHelpTextCore()

Returns

string

GetItem(int, int)

Retrieves the UI Automation provider for the specified cell.

Declaration

cs-api-definition
public IRawElementProviderSimple GetItem(int row, int column)

Parameters

row

int

The ordinal number of the row of interest.

column

int

The ordinal number of the column of interest.

Returns

IRawElementProviderSimple

The UI Automation provider for the specified cell.

GetItemStatusCore()

Declaration

cs-api-definition
protected override string GetItemStatusCore()

Returns

string

GetLocalizedControlTypeCore()

When overridden in a derived class, is called by .

Declaration

cs-api-definition
protected override string GetLocalizedControlTypeCore()

Returns

string

The type of the control.

GetNameCore()

Gets the text label of the that is associated with this . 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.

GetPattern(PatternInterface)

Gets the control pattern for the UIElement that is associated with this .

Declaration

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

Parameters

patternInterface

PatternInterface

A value from the enumeration.

Returns

object

An object that implements the interface if patternInterface is ; otherwise, null.

GetRowHeaders()

Retrieves a collection of UI Automation providers that represents all row headers in the table.

Declaration

cs-api-definition
public IRawElementProviderSimple[] GetRowHeaders()

Returns

IRawElementProviderSimple[]

A collection of UI Automation providers.

GetSelection()

Retrieves a UI Automation provider for each child element that is selected.

Declaration

cs-api-definition
public IRawElementProviderSimple[] GetSelection()

Returns

IRawElementProviderSimple[]

A collection of UI Automation providers.

GetSupportedViews()

Retrieves a collection of control-specific view identifiers.

Declaration

cs-api-definition
public int[] GetSupportedViews()

Returns

int[]

A collection of values that identifies the views available for a UI Automation element.

GetViewName(int)

Retrieves the name of a control-specific view.

Declaration

cs-api-definition
public string GetViewName(int viewId)

Parameters

viewId

int

The view identifier.

Returns

string

A localized name for the view.

Exceptions

ArgumentException

viewId is not a member of the supported views collection.

SetCurrentView(int)

Sets the current control-specific view.

Declaration

cs-api-definition
public void SetCurrentView(int viewId)

Parameters

viewId

int

A view identifier.

Exceptions

ArgumentException

viewId is not a member of the supported views collection.