Поделиться через

AutomationElement.GetCurrentPropertyValue Метод

  • Ссылка

Определение

Пространство имен:
System.Windows.Automation
Сборка:
UIAutomationClient.dll

Возвращает текущее значение заданного свойства из объекта AutomationElement.

Перегрузки

GetCurrentPropertyValue(AutomationProperty)

Возвращает значение заданного свойства для данного объекта AutomationElement. Для свойств, явно не поддерживаемых целевым элементом пользовательского интерфейса, возвращается соответствующее значение по умолчанию для типа свойства.
GetCurrentPropertyValue(AutomationProperty, Boolean)

Извлекает значение заданного свойства для данного объекта AutomationElement. Свойство по умолчанию может пропускаться.

Комментарии

Значение, возвращаемое методом GetCurrentPropertyValue , является текущим во время его вызова. Значение может впоследствии измениться другими приложениями, взаимодействующими с пользовательским интерфейсом.

Для некоторых форм пользовательского интерфейса этот метод приведет к дополнительным издержкам производительности между процессами. Приложения могут сосредоточиться на дополнительных затратах путем кэширования свойств, а затем получения их с помощью GetCachedPropertyValue.

GetCurrentPropertyValue(AutomationProperty)

Возвращает значение заданного свойства для данного объекта AutomationElement. Для свойств, явно не поддерживаемых целевым элементом пользовательского интерфейса, возвращается соответствующее значение по умолчанию для типа свойства.

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

Параметры

property
AutomationProperty

Идентификатор свойства модели автоматизации пользовательского интерфейса, указывающий, какое свойство следует извлечь.

Возвращаемое значение

Object

Объект, содержащий значение заданного свойства.

Исключения

ElementNotAvailableException

Пользовательский интерфейс для AutomationElement больше не существует.

Примеры

В следующем примере извлекается текущее HelpText значение свойства . Значение по умолчанию возвращается, если элемент не предоставляет его.

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

Комментарии

Значение, возвращаемое методом GetCurrentPropertyValue , является текущим во время его вызова. Значение может впоследствии измениться другими приложениями, взаимодействующими с пользовательским интерфейсом.

Если поставщик автоматизации пользовательского интерфейса для самого элемента поддерживает свойство , возвращается значение свойства . В противном случае возвращается свойство по умолчанию, указанное в модели автоматизации пользовательского интерфейса. Сведения о свойствах по умолчанию см. в полях идентификатора AutomationElementсвойства , например AcceleratorKeyProperty.

Для некоторых форм пользовательского интерфейса этот метод приведет к дополнительным издержкам производительности между процессами. Сконцентрируйте затраты путем кэширования свойств, а затем получения их с помощью GetCachedPropertyValue.

Применяется к

GetCurrentPropertyValue(AutomationProperty, Boolean)

Извлекает значение заданного свойства для данного объекта AutomationElement. Свойство по умолчанию может пропускаться.

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

Параметры

property
AutomationProperty

Идентификатор свойства модели автоматизации пользовательского интерфейса, указывающий, какое свойство следует извлечь.

ignoreDefaultValue
Boolean

Значение, которое определяет, должно ли пропускаться значение по умолчанию, если заданное свойство поддерживается.

Возвращаемое значение

Object

Объект, содержащий значение заданного свойства, или значение NotSupported, если элемент не возвращает значение, и параметр ignoreDefaultValue имеет значение true.

Исключения

ElementNotAvailableException

Пользовательский интерфейс для AutomationElement больше не существует.

Примеры

В следующем примере извлекается текущее HelpText значение свойства, но указывается, что если сам элемент не предоставляет значение для свойства, NotSupported возвращается вместо значения по умолчанию.

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

Комментарии

Передача false эквивалентна ignoreDefaultValue вызову AutomationElement.GetCurrentPropertyValue(AutomationProperty).

Если поставщик автоматизации пользовательского интерфейса для самого элемента поддерживает свойство , возвращается значение свойства . В противном случае, если ignoreDefaultValue имеет значение false, возвращается свойство по умолчанию, указанное в модели автоматизации пользовательского интерфейса. Сведения о свойствах по умолчанию см. в полях идентификатора AutomationElementсвойства , например AcceleratorKeyProperty.

Значение, возвращаемое методом GetCurrentPropertyValue , является текущим во время его вызова. Значение может впоследствии измениться другими приложениями, взаимодействующими с пользовательским интерфейсом.

Для некоторых форм пользовательского интерфейса этот метод приведет к дополнительным издержкам производительности между процессами. Приложения могут сосредоточиться на дополнительных затратах путем кэширования свойств, а затем получения их с помощью GetCachedPropertyValue.

Применяется к