AutomationElement.GetCurrentPropertyValue Methode

Definitie

Naamruimte:: System.Windows.Automation

Assembly:: UIAutomationClient.dll

Belangrijk

Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.

Haalt de huidige waarde van de opgegeven eigenschap op uit een AutomationElement.

Overloads

Name	Description
GetCurrentPropertyValue(AutomationProperty)	Haalt de waarde van de opgegeven eigenschap op deze AutomationElement. Er wordt een juiste standaardwaarde voor het eigenschapstype geretourneerd voor eigenschappen die niet expliciet worden ondersteund door het gebruikersinterfaceelement (UI) van het doel.
GetCurrentPropertyValue(AutomationProperty, Boolean)	Haalt de waarde van de opgegeven eigenschap op deze AutomationElementoptioneel negeren van een standaardeigenschap.

Opmerkingen

De waarde die door de GetCurrentPropertyValue methode wordt geretourneerd, is actueel op het moment dat deze wordt aangeroepen. De waarde kan vervolgens worden gewijzigd door andere toepassingen die communiceren met de gebruikersinterface (UI).

Voor sommige vormen van gebruikersinterface leidt deze methode tot overhead voor de prestaties van meerdere processen. Toepassingen kunnen overhead concentreren door eigenschappen in de cache op te slaan en ze vervolgens op te halen met behulp van GetCachedPropertyValue.

GetCurrentPropertyValue(AutomationProperty)

Haalt de waarde van de opgegeven eigenschap op deze AutomationElement. Er wordt een juiste standaardwaarde voor het eigenschapstype geretourneerd voor eigenschappen die niet expliciet worden ondersteund door het gebruikersinterfaceelement (UI) van het doel.

public:
 System::Object ^ GetCurrentPropertyValue(System::Windows::Automation::AutomationProperty ^ property);

public object GetCurrentPropertyValue(System.Windows.Automation.AutomationProperty property);

member this.GetCurrentPropertyValue : System.Windows.Automation.AutomationProperty -> obj

Public Function GetCurrentPropertyValue (property As AutomationProperty) As Object

Parameters

property: AutomationProperty

De UI Automation eigenschaps-id die aangeeft welke eigenschap moet worden opgehaald.

Retouren

Object

Een object met de waarde van de opgegeven eigenschap.

Uitzonderingen

ElementNotAvailableException

De gebruikersinterface voor de AutomationElement app bestaat niet meer.

Voorbeelden

In het volgende voorbeeld wordt de huidige waarde van de HelpText eigenschap opgehaald. De standaardwaarde wordt geretourneerd als het element er geen opgeeft.

// elementList is an AutomationElement.
string helpString =
    elementList.GetCurrentPropertyValue(AutomationElement.HelpTextProperty) as string;

' elementList is an AutomationElement.
Dim helpString As String = _
    CStr(elementList.GetCurrentPropertyValue(AutomationElement.HelpTextProperty))

Opmerkingen

Als de UI Automation-provider voor het element zelf de eigenschap ondersteunt, wordt de waarde van de eigenschap geretourneerd. Anders wordt een standaardeigenschap geretourneerd die is opgegeven door UI Automation. Zie de eigenschappen-id-velden van AutomationElement, zoals AcceleratorKeyProperty.

Voor sommige vormen van gebruikersinterface leidt deze methode tot overhead voor de prestaties van meerdere processen. U kunt overhead concentreren door eigenschappen in de cache op te slaan en deze vervolgens op te halen met behulp van GetCachedPropertyValue.

Van toepassing op

GetCurrentPropertyValue(AutomationProperty, Boolean)

Haalt de waarde van de opgegeven eigenschap op deze AutomationElementoptioneel negeren van een standaardeigenschap.

public:
 System::Object ^ GetCurrentPropertyValue(System::Windows::Automation::AutomationProperty ^ property, bool ignoreDefaultValue);

public object GetCurrentPropertyValue(System.Windows.Automation.AutomationProperty property, bool ignoreDefaultValue);

member this.GetCurrentPropertyValue : System.Windows.Automation.AutomationProperty * bool -> obj

Public Function GetCurrentPropertyValue (property As AutomationProperty, ignoreDefaultValue As Boolean) As Object

Parameters

property: AutomationProperty

De UI Automation eigenschaps-id die aangeeft welke eigenschap moet worden opgehaald.

ignoreDefaultValue: Boolean

Een waarde die aangeeft of een standaardwaarde moet worden genegeerd als de opgegeven eigenschap wordt ondersteund.

Retouren

Object

Een object met de waarde van de opgegeven eigenschap of NotSupported als het element geen waarde levert en ignoreDefaultValue wel true.

Uitzonderingen

ElementNotAvailableException

De gebruikersinterface voor de AutomationElement app bestaat niet meer.

Voorbeelden

In het volgende voorbeeld wordt de huidige waarde van de HelpText eigenschap opgehaald, maar wordt aangegeven dat als het element zelf geen waarde voor de eigenschap biedt, NotSupported moet worden geretourneerd in plaats van een standaardwaarde.

// elementList is an AutomationElement.
object help = elementList.GetCurrentPropertyValue(AutomationElement.HelpTextProperty, true);
if (help == AutomationElement.NotSupported)
{
    help = "No help available";
}
string helpText = (string)help;

' elementList is an AutomationElement.
Dim help As Object = elementList.GetCurrentPropertyValue(AutomationElement.HelpTextProperty, True)
If help Is AutomationElement.NotSupported Then
    help = "No help available"
End If
Dim helpText As String = CStr(help)

Opmerkingen

ignoreDefaultValue Doorgeven false komt overeen met bellenAutomationElement.GetCurrentPropertyValue(AutomationProperty).

Als de UI Automation-provider voor het element zelf de eigenschap ondersteunt, wordt de waarde van de eigenschap geretourneerd. Als ignoreDefaultValuefalse is, wordt een standaardeigenschap geretourneerd die is opgegeven door UI Automation. Zie de eigenschappen-id-velden van AutomationElement, zoals AcceleratorKeyProperty.

Van toepassing op

Feedback

Is deze pagina nuttig?