Expand Minimize

AutomationPeer.GetLabeledBy Method

Gets the AutomationPeer for the Label that is targeted to the element.

Namespace:  System.Windows.Automation.Peers
Assembly:  PresentationCore (in PresentationCore.dll)

public AutomationPeer GetLabeledBy()

Return Value

Type: System.Windows.Automation.Peers.AutomationPeer
The LabelAutomationPeer for the element that is targeted by the Label.

For example, if the element is a ComboBox control, the GetLabeledBy method gets the AutomationPeer for the Label that is associated with the ComboBox.

In the following image, the Label "Themes" is targeted to the ComboBox; therefore the AccessKey for the Label also targets the ComboBox. When the user presses ALT+T, the ComboBox gets focus instead of the Label.

Display properties shows labeled by usage

The GetLabeledBy method for ComboBoxAutomationPeer returns the LabelAutomationPeer for the corresponding Label. This enables an automation client to get the text string that describes the ComboBox.

.NET Framework

Supported in: 4, 3.5, 3.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
Was this page helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft