AutomationElement.GetCurrentPropertyValue Metoda

Definice

Obor názvů:

System.Windows.Automation

Sestavení:

UIAutomationClient.dll

Načte aktuální hodnotu zadané vlastnosti z objektu AutomationElement.

Přetížení

Name	Description
GetCurrentPropertyValue(AutomationProperty)	Načte hodnotu zadané vlastnosti pro tuto AutomationElement. Pro vlastnosti, které cílový prvek uživatelského rozhraní explicitně nepodporuje, se vrátí odpovídající výchozí hodnota pro typ vlastnosti.
GetCurrentPropertyValue(AutomationProperty, Boolean)	Načte hodnotu zadané vlastnosti na tomto AutomationElement, volitelně ignorování jakékoli výchozí vlastnosti.

Poznámky

Hodnota vrácená metodou GetCurrentPropertyValue je aktuální v době, kdy je volána. Hodnota se následně může změnit jinými aplikacemi, které pracují s uživatelským rozhraním.

U některých forem uživatelského rozhraní bude tato metoda způsobovat režijní náklady na výkon napříč procesy. Aplikace se můžou soustředit na režii tím, že ukládají vlastnosti do mezipaměti a pak je načítají pomocí GetCachedPropertyValue.

GetCurrentPropertyValue(AutomationProperty)

Načte hodnotu zadané vlastnosti pro tuto AutomationElement. Pro vlastnosti, které cílový prvek uživatelského rozhraní explicitně nepodporuje, se vrátí odpovídající výchozí hodnota pro typ vlastnosti.

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

Identifikátor vlastnosti Automatizace uživatelského rozhraní určující, která vlastnost se má načíst.

Návraty

Object

Objekt obsahující hodnotu zadané vlastnosti.

Výjimky

ElementNotAvailableException

Uživatelské rozhraní AutomationElement již neexistuje.

Příklady

Následující příklad načte aktuální hodnotu HelpText vlastnosti. Výchozí hodnota se vrátí, pokud prvek nezadá jednu.

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

Poznámky

Hodnota vrácená metodou GetCurrentPropertyValue je aktuální v době, kdy je volána. Hodnota se následně může změnit jinými aplikacemi, které pracují s uživatelským rozhraním.

Pokud zprostředkovatel automatizace uživatelského rozhraní pro samotný prvek podporuje vlastnost, vrátí se hodnota vlastnosti. V opačném případě se vrátí výchozí vlastnost určená automatizací uživatelského rozhraní. Informace o výchozích vlastnostech naleznete v polích identifikátorů AutomationElementvlastnosti , například AcceleratorKeyProperty.

U některých forem uživatelského rozhraní bude tato metoda způsobovat režijní náklady na výkon napříč procesy. Zaměřte režii tím, že vlastnosti mezipaměti uložíte do mezipaměti a pak je načítáte pomocí .GetCachedPropertyValue

GetCurrentPropertyValue(AutomationProperty, Boolean)

Načte hodnotu zadané vlastnosti na tomto AutomationElement, volitelně ignorování jakékoli výchozí vlastnosti.

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

Identifikátor vlastnosti Automatizace uživatelského rozhraní určující, která vlastnost se má načíst.

ignoreDefaultValue

Boolean

Hodnota, která určuje, zda má být výchozí hodnota ignorována, pokud je zadaná vlastnost podporována.

Návraty

Object

Objekt obsahující hodnotu zadané vlastnosti, nebo NotSupported pokud prvek nezadává hodnotu a ignoreDefaultValue je true.

Výjimky

ElementNotAvailableException

Uživatelské rozhraní AutomationElement již neexistuje.

Příklady

Následující příklad načte aktuální hodnotu HelpText vlastnosti, ale určuje, že pokud samotný prvek neposkytuje hodnotu vlastnosti, NotSupported je vrácena místo výchozí hodnoty.

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

Poznámky

ignoreDefaultValue Předávání false je ekvivalentní volání AutomationElement.GetCurrentPropertyValue(AutomationProperty).

Pokud zprostředkovatel automatizace uživatelského rozhraní pro samotný prvek podporuje vlastnost, vrátí se hodnota vlastnosti. V opačném případě je ignoreDefaultValuefalsevrácena výchozí vlastnost určená automatizací uživatelského rozhraní. Informace o výchozích vlastnostech naleznete v polích identifikátorů AutomationElementvlastnosti , například AcceleratorKeyProperty.

Hodnota vrácená metodou GetCurrentPropertyValue je aktuální v době, kdy je volána. Hodnota se následně může změnit jinými aplikacemi, které pracují s uživatelským rozhraním.

U některých forem uživatelského rozhraní bude tato metoda způsobovat režijní náklady na výkon napříč procesy. Aplikace se můžou soustředit na režii tím, že ukládají vlastnosti do mezipaměti a pak je načítají pomocí GetCachedPropertyValue.