AutomationElement.GetCurrentPropertyValue Метод

Ссылка

Определение

Пространство имен:: System.Windows.Automation

Сборка:: UIAutomationClient.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

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

Перегрузки

GetCurrentPropertyValue(AutomationProperty)

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

GetCurrentPropertyValue(AutomationProperty, Boolean)

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

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

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

GetCurrentPropertyValue(AutomationProperty)

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

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

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

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

GetCurrentPropertyValue(AutomationProperty, Boolean)

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)

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

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

AutomationElement.GetCurrentPropertyValue Метод

Определение

Перегрузки

Комментарии

GetCurrentPropertyValue(AutomationProperty)

Параметры

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

Исключения

Примеры

Комментарии

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

GetCurrentPropertyValue(AutomationProperty, Boolean)

Параметры

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

Исключения

Примеры

Комментарии

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

Обратная связь

Дополнительные ресурсы