AutomationElement.GetCurrentPropertyValue Metoda

Definicja

Przestrzeń nazw:

System.Windows.Automation

Zestaw:

UIAutomationClient.dll

Pobiera bieżącą wartość określonej właściwości z obiektu AutomationElement.

Przeciążenia

GetCurrentPropertyValue(AutomationProperty)	Pobiera wartość określonej właściwości w tym AutomationElementobiekcie . Odpowiednia wartość domyślna typu właściwości jest zwracana dla właściwości, które nie są jawnie obsługiwane przez docelowy element interfejsu użytkownika.
GetCurrentPropertyValue(AutomationProperty, Boolean)	Pobiera wartość określonej właściwości w tym AutomationElementobiekcie , opcjonalnie ignorując dowolną właściwość domyślną.

Uwagi

Wartość zwracana przez metodę GetCurrentPropertyValue jest bieżąca w momencie jej wywołania. Wartość może następnie ulec zmianie przez inne aplikacje korzystające z interfejsu użytkownika.

W przypadku niektórych form interfejsu użytkownika ta metoda spowoduje obciążenie związane z wydajnością między procesami. Aplikacje mogą skoncentrować obciążenie poprzez buforowanie właściwości, a następnie pobieranie ich przy użyciu polecenia GetCachedPropertyValue.

GetCurrentPropertyValue(AutomationProperty)

Pobiera wartość określonej właściwości w tym AutomationElementobiekcie . Odpowiednia wartość domyślna typu właściwości jest zwracana dla właściwości, które nie są jawnie obsługiwane przez docelowy element interfejsu użytkownika.

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

Parametry

property

AutomationProperty

Identyfikator właściwości automatyzacja interfejsu użytkownika określający, która właściwość ma być pobierana.

Zwraca

Object

Obiekt zawierający wartość określonej właściwości.

Wyjątki

ElementNotAvailableException

Interfejs użytkownika dla AutomationElement obiektu już nie istnieje.

Przykłady

Poniższy przykład pobiera bieżącą wartość HelpText właściwości. Wartość domyślna jest zwracana, jeśli element nie podaje go.

// 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))

Uwagi

Wartość zwracana przez metodę GetCurrentPropertyValue jest bieżąca w momencie jej wywołania. Wartość może następnie ulec zmianie przez inne aplikacje wchodzące w interakcję z interfejsem użytkownika.

Jeśli dostawca automatyzacja interfejsu użytkownika dla samego elementu obsługuje właściwość, zwracana jest wartość właściwości. W przeciwnym razie zwracana jest właściwość domyślna określona przez automatyzacja interfejsu użytkownika. Aby uzyskać informacje na temat właściwości domyślnych, zobacz pola identyfikatora właściwości , AutomationElementtakie jak AcceleratorKeyProperty.

W przypadku niektórych form interfejsu użytkownika ta metoda spowoduje obciążenie związane z wydajnością między procesami. Skoncentruj obciążenie przez buforowanie właściwości, a następnie pobieraj je przy użyciu polecenia GetCachedPropertyValue.

GetCurrentPropertyValue(AutomationProperty, Boolean)

Pobiera wartość określonej właściwości w tym AutomationElementobiekcie , opcjonalnie ignorując dowolną właściwość domyślną.

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

Parametry

property

AutomationProperty

Identyfikator właściwości automatyzacja interfejsu użytkownika określający, która właściwość ma być pobierana.

ignoreDefaultValue

Boolean

Wartość określająca, czy wartość domyślna powinna być ignorowana, jeśli określona właściwość jest obsługiwana.

Zwraca

Object

Obiekt zawierający wartość określonej właściwości lub NotSupported jeśli element nie dostarcza wartości i ignoreDefaultValue jest true.

Wyjątki

ElementNotAvailableException

Interfejs użytkownika dla AutomationElement obiektu już nie istnieje.

Przykłady

Poniższy przykład pobiera bieżącą wartość HelpText właściwości, ale określa, że jeśli sam element nie podaje wartości właściwości, NotSupported należy zwrócić zamiast wartości domyślnej.

// 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)

Uwagi

Przekazywanie falseignoreDefaultValue jest równoważne wywołaniu metody AutomationElement.GetCurrentPropertyValue(AutomationProperty).

Jeśli dostawca automatyzacja interfejsu użytkownika dla samego elementu obsługuje właściwość, zwracana jest wartość właściwości. W przeciwnym razie zwracana ignoreDefaultValue jest falsewłaściwość domyślna określona przez automatyzacja interfejsu użytkownika. Aby uzyskać informacje na temat właściwości domyślnych, zobacz pola identyfikatora właściwości , AutomationElementtakie jak AcceleratorKeyProperty.

Wartość zwracana przez metodę GetCurrentPropertyValue jest bieżąca w momencie jej wywołania. Wartość może następnie ulec zmianie przez inne aplikacje korzystające z interfejsu użytkownika.

W przypadku niektórych form interfejsu użytkownika ta metoda spowoduje obciążenie związane z wydajnością między procesami. Aplikacje mogą skoncentrować obciążenie poprzez buforowanie właściwości, a następnie pobieranie ich przy użyciu polecenia GetCachedPropertyValue.