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í

GetCurrentPropertyValue(AutomationProperty)	Načte hodnotu zadané vlastnosti pro tento AutomationElement. Pro vlastnosti, které nejsou explicitně podporovány elementem cílového uživatelského rozhraní (UI) je vrácena odpovídající výchozí hodnota pro typ vlastnosti.
GetCurrentPropertyValue(AutomationProperty, Boolean)	Načte hodnotu zadané vlastnosti u tohoto AutomationElementobjektu , volitelně ignoruje jakoukoli výchozí vlastnost.

Poznámky

Hodnota vrácená metodou GetCurrentPropertyValue je aktuální v době, kdy je volána. Hodnota se může následně měnit v poté, co jiné aplikace 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 mezi procesy. Aplikace můžou soustředit režii tím, že vlastnosti uloží do mezipaměti a pak je načítají pomocí .GetCachedPropertyValue

GetCurrentPropertyValue(AutomationProperty)

Načte hodnotu zadané vlastnosti pro tento AutomationElement. Pro vlastnosti, které nejsou explicitně podporovány elementem cílového uživatelského rozhraní (UI) je vrácena 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í pro objekt AutomationElement už neexistuje.

Příklady

Následující příklad načte aktuální hodnotu HelpText vlastnosti . Pokud element hodnotu neposkytuje, vrátí se výchozí hodnota.

// 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 může následně změnit v jiných aplikacích, 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 najdete v polích identifikátorů vlastností , AutomationElementnapříklad AcceleratorKeyProperty.

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

GetCurrentPropertyValue(AutomationProperty, Boolean)

Načte hodnotu zadané vlastnosti u tohoto AutomationElementobjektu , volitelně ignoruje jakoukoli výchozí vlastnost.

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 neposkytuje hodnotu a ignoreDefaultValue je true.

Výjimky

ElementNotAvailableException

Uživatelské rozhraní pro objekt AutomationElement už neexistuje.

Příklady

Následující příklad načte aktuální hodnotu HelpText vlastnosti, ale určuje, že pokud samotný prvek neposkytuje hodnotu pro vlastnost, NotSupported bude 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ání false je ekvivalentem volání AutomationElement.GetCurrentPropertyValue(AutomationProperty)metody .

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 ignoreDefaultValuefalsevrátí výchozí vlastnost určená automatizací uživatelského rozhraní. Informace o výchozích vlastnostech najdete v polích identifikátorů vlastností , AutomationElementnapříklad AcceleratorKeyProperty.

Hodnota vrácená metodou GetCurrentPropertyValue je aktuální v době, kdy je volána. Hodnota se může následně měnit v poté, co jiné aplikace 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 mezi procesy. Aplikace můžou soustředit režii tím, že vlastnosti uloží do mezipaměti a pak je načítají pomocí .GetCachedPropertyValue