AutomationPeer.GetLabeledBy メソッド


要素を対象とする LabelAutomationPeer を取得します。Gets the AutomationPeer for the Label that is targeted to the element.

 System::Windows::Automation::Peers::AutomationPeer ^ GetLabeledBy();
public System.Windows.Automation.Peers.AutomationPeer GetLabeledBy ();
member this.GetLabeledBy : unit -> System.Windows.Automation.Peers.AutomationPeer
Public Function GetLabeledBy () As AutomationPeer



Label によりターゲットとされる要素の LabelAutomationPeerThe LabelAutomationPeer for the element that is targeted by the Label.


このメソッドのパブリック呼び出しが現在進行中です。A public call to this method is currently in progress.


たとえば、要素がコントロールの場合、 ComboBox GetLabeledBy メソッドは AutomationPeer Label 、に関連付けられているのを取得し ComboBox ます。For example, if the element is a ComboBox control, the GetLabeledBy method gets the AutomationPeer for the Label that is associated with the ComboBox.

次の図では、"theme" はを対象としています。したがって、のでは、も対象と Label ComboBox AccessKey Label ComboBox なります。In the following image, the Label "Themes" is targeted to the ComboBox; therefore the AccessKey for the Label also targets the ComboBox. ユーザーが ALT Tキーを押すと、はでは + T ComboBox なくフォーカスを取得し Label ます。When the user presses ALT+T, the ComboBox gets focus instead of the Label.

使用状況によってラベル付けを表示するプロパティを表示するDisplay properties shows labeled by usage

GetLabeledByのメソッドは、 ComboBoxAutomationPeer 対応するのを返し LabelAutomationPeer Label ます。The GetLabeledBy method for ComboBoxAutomationPeer returns the LabelAutomationPeer for the corresponding Label. これにより、オートメーションクライアントは、を記述するテキスト文字列を取得でき ComboBox ます。This enables an automation client to get the text string that describes the ComboBox.