AutomationElement.LabeledByProperty 欄位

定義

識別 LabeledBy 屬性,該屬性會識別與控制項關聯的標籤。Identifies the LabeledBy property, which identifies the label associated with a control.

public: static initonly System::Windows::Automation::AutomationProperty ^ LabeledByProperty;
public static readonly System.Windows.Automation.AutomationProperty LabeledByProperty;
 staticval mutable LabeledByProperty : System.Windows.Automation.AutomationProperty
Public Shared ReadOnly LabeledByProperty As AutomationProperty 

欄位值

AutomationProperty

範例

下列範例會抓取屬性的目前值。The following example retrieves the current value of the property. 如果元素未提供預設值,則會傳回預設值。The default value is returned if the element does not provide one.

AutomationElement labeler =
    autoElement.GetCurrentPropertyValue(AutomationElement.LabeledByProperty) as AutomationElement;
Dim labeler As AutomationElement = _
    DirectCast(autoElement.GetCurrentPropertyValue(AutomationElement.LabeledByProperty), _
    AutomationElement)

下列範例會抓取屬性目前的值,但指定如果專案本身未提供屬性的值, NotSupported 則會傳回而不是預設值。The following example retrieves the current value of the property, but specifies that if the element itself does not provide a value for the property, NotSupported is to be returned instead of a default value.

AutomationElement labeler1;
object labelerNoDefault =
    autoElement.GetCurrentPropertyValue(AutomationElement.LabeledByProperty, true);
if (labelerNoDefault == AutomationElement.NotSupported)
{
    // TODO Handle the case where you do not wish to proceed using the default value.
}
else
{
    labeler1 = labelerNoDefault as AutomationElement;
}
Dim labeler1 As AutomationElement
Dim labelerNoDefault As Object = autoElement.GetCurrentPropertyValue(AutomationElement.LabeledByProperty, True)
If labelerNoDefault Is AutomationElement.NotSupported Then
    ' TODO Handle the case where you do not wish to proceed using the default value.
Else
    labeler1 = DirectCast(labelerNoDefault, AutomationElement)
End If

備註

消費者介面自動化用戶端應用程式會使用此識別碼。This identifier is used by UI Automation client applications. 消費者介面自動化提供者應該在中使用對等的識別碼 AutomationElementIdentifiersUI Automation providers should use the equivalent identifier in AutomationElementIdentifiers.

這個屬性也可以從 Current 或屬性中抓取 CachedThis property can also be retrieved from the Current or Cached properties.

屬性的傳回值屬於類型 AutomationElementReturn values of the property are of type AutomationElement. 屬性的預設值為 nullThe default value for the property is null.

適用於