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

AutomationElement.GetCurrentPropertyValue Метод

Определение

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

Извлекает текущее значение указанного свойства из объекта AutomationElement.

Перегрузки

Имя Описание
GetCurrentPropertyValue(AutomationProperty)

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

Извлекает значение указанного свойства для этого AutomationElement, при необходимости игнорируя любое свойство по умолчанию.

Комментарии

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

Для некоторых форм пользовательского интерфейса этот метод приведет к перекрестным затратам на производительность. Приложения могут сосредоточиться на затратах путем кэширования свойств, а затем получения их с помощью 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)

Комментарии

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

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

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

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

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