AutomationElement.GetCurrentPropertyValue AutomationElement.GetCurrentPropertyValue AutomationElement.GetCurrentPropertyValue AutomationElement.GetCurrentPropertyValue Method

정의

AutomationElement에서 지정된 속성의 현재 값을 검색합니다.Retrieves the current value of the specified property from an AutomationElement.

오버로드

GetCurrentPropertyValue(AutomationProperty) GetCurrentPropertyValue(AutomationProperty) GetCurrentPropertyValue(AutomationProperty) GetCurrentPropertyValue(AutomationProperty)

AutomationElement의 지정된 속성 값을 검색합니다.Retrieves the value of the specified property on this AutomationElement. 대상 UI(사용자 인터페이스)user interface (UI) 요소에서 해당 속성을 명시적으로 지원하지 않는 경우에는 속성 형식의 적절한 기본값이 반환됩니다.An appropriate default value for the property type is returned for properties not explicitly supported by the target UI(사용자 인터페이스)user interface (UI) element.

GetCurrentPropertyValue(AutomationProperty, Boolean) GetCurrentPropertyValue(AutomationProperty, Boolean) GetCurrentPropertyValue(AutomationProperty, Boolean) GetCurrentPropertyValue(AutomationProperty, Boolean)

AutomationElement에서 지정된 속성의 값을 검색하고, 기본 속성을 선택적으로 무시할 수 있습니다.Retrieves the value of the specified property on this AutomationElement, optionally ignoring any default property.

설명

반환한 값은 GetCurrentPropertyValue 메서드는 호출 시 현재 합니다.The value returned by the GetCurrentPropertyValue method is current at the time it is called. 값 수와 상호 작용 하는 다른 애플리케이션에서 이후에 변경 된 UI(사용자 인터페이스)user interface (UI)합니다.The value can subsequently change by other applications interacting with the UI(사용자 인터페이스)user interface (UI).

일부 형태의 UIUI,이 메서드는 크로스 프로세스 성능 오버 헤드가 부과 됩니다.For some forms of UIUI, this method will incur cross-process performance overhead. 애플리케이션 속성을 사용 하 여 검색 한 다음 오버 헤드가 집중할 수 GetCachedPropertyValue입니다.Applications can concentrate overhead by caching properties and then retrieving them by using GetCachedPropertyValue.

GetCurrentPropertyValue(AutomationProperty) GetCurrentPropertyValue(AutomationProperty) GetCurrentPropertyValue(AutomationProperty) GetCurrentPropertyValue(AutomationProperty)

AutomationElement의 지정된 속성 값을 검색합니다.Retrieves the value of the specified property on this AutomationElement. 대상 UI(사용자 인터페이스)user interface (UI) 요소에서 해당 속성을 명시적으로 지원하지 않는 경우에는 속성 형식의 적절한 기본값이 반환됩니다.An appropriate default value for the property type is returned for properties not explicitly supported by the target UI(사용자 인터페이스)user interface (UI) element.

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

검색할 속성을 지정하는 UI 자동화UI Automation 속성 식별자입니다.The UI 자동화UI Automation property identifier specifying which property to retrieve.

반환

지정된 속성의 값이 들어 있는 개체입니다.An object containing the value of the specified property.

예외

예제

다음 예제에서는 변수의 현재 값을 검색 합니다 HelpText 속성입니다.The following example retrieves the current value of the HelpText property. 요소 하나를 제공 하지 않는 경우 기본값 반환 됩니다.The default value is returned if the element does not provide one.

// 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 메서드는 호출 시 현재 합니다.The value returned by the GetCurrentPropertyValue method is current at the time it is called. 값 수와 상호 작용 하는 다른 애플리케이션에서 이후에 변경 된 UIUI합니다.The value can subsequently change by other applications interacting with the UIUI.

요소 자체에 대 한 UI 자동화 공급자의 속성을 지 원하는 속성의 값이 반환 됩니다.If the UI Automation provider for the element itself supports the property, the value of the property is returned. 기본 속성을 지정 하는 고, 그렇지 UI 자동화UI Automation 반환 됩니다.Otherwise, a default property specified by UI 자동화UI Automation is returned. 참조 속성 식별자 필드의 기본 속성에 대 한 내용은 AutomationElement와 같은 AcceleratorKeyProperty합니다.For information on default properties, see the property identifier fields of AutomationElement, such as AcceleratorKeyProperty.

일부 형태의 UIUI,이 메서드는 크로스 프로세스 성능 오버 헤드가 부과 됩니다.For some forms of UIUI, this method will incur cross-process performance overhead. 캐싱 속성 및 사용 하 여 검색 하 여 오버 헤드 전체가 대상 이지만 GetCachedPropertyValue합니다.Concentrate overhead by caching properties and then retrieving them by using GetCachedPropertyValue.

GetCurrentPropertyValue(AutomationProperty, Boolean) GetCurrentPropertyValue(AutomationProperty, Boolean) GetCurrentPropertyValue(AutomationProperty, Boolean) GetCurrentPropertyValue(AutomationProperty, Boolean)

AutomationElement에서 지정된 속성의 값을 검색하고, 기본 속성을 선택적으로 무시할 수 있습니다.Retrieves the value of the specified property on this AutomationElement, optionally ignoring any default property.

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

검색할 속성을 지정하는 UI 자동화UI Automation 속성 식별자입니다.The UI 자동화UI Automation property identifier specifying which property to retrieve.

ignoreDefaultValue
Boolean Boolean Boolean Boolean

지정된 속성이 지원되는 경우 기본값을 무시할지 여부를 지정하는 값입니다.A value that specifies whether a default value should be ignored if the specified property is supported.

반환

지정된 속성의 값이 들어 있는 개체이거나, 요소에서 값을 제공하지 않고 ignoreDefaultValuetrue인 경우 NotSupported입니다.An object containing the value of the specified property, or NotSupported if the element does not supply a value and ignoreDefaultValue is true.

예외

예제

현재 값을 검색 하는 다음 예제는 HelpText 속성을 지정 하는 요소 자체의 속성에 대 한 값을 제공 하지 않는 경우 NotSupported 대신 기본값을 반환 하는 것입니다.The following example retrieves the current value of the HelpText property, but specifies that if the element itself does not provide a value for the property, NotSupported is to be returned instead of a default value.

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

설명

전달 falseignoreDefaultValue 호출 하는 것과 같습니다 AutomationElement.GetCurrentPropertyValue(AutomationProperty)합니다.Passing false in ignoreDefaultValue is equivalent to calling AutomationElement.GetCurrentPropertyValue(AutomationProperty).

요소 자체에 대 한 UI 자동화 공급자의 속성을 지 원하는 속성의 값이 반환 됩니다.If the UI Automation provider for the element itself supports the property, the value of the property is returned. 그렇지 않은 경우, ignoreDefaultValue 됩니다 false, 지정 된 기본 속성을 UI 자동화UI Automation 반환 됩니다.Otherwise, if ignoreDefaultValue is false, a default property specified by UI 자동화UI Automation is returned. 참조 속성 식별자 필드의 기본 속성에 대 한 내용은 AutomationElement와 같은 AcceleratorKeyProperty합니다.For information on default properties, see the property identifier fields of AutomationElement, such as AcceleratorKeyProperty.

반환한 값은 GetCurrentPropertyValue 메서드는 호출 시 현재 합니다.The value returned by the GetCurrentPropertyValue method is current at the time it is called. 값 수와 상호 작용 하는 다른 애플리케이션에서 이후에 변경 된 UI(사용자 인터페이스)user interface (UI)합니다.The value can subsequently change by other applications interacting with the UI(사용자 인터페이스)user interface (UI).

일부 형태의 UIUI,이 메서드는 크로스 프로세스 성능 오버 헤드가 부과 됩니다.For some forms of UIUI, this method will incur cross-process performance overhead. 애플리케이션 속성을 사용 하 여 검색 한 다음 오버 헤드가 집중할 수 GetCachedPropertyValue입니다.Applications can concentrate overhead by caching properties and then retrieving them by using GetCachedPropertyValue.

적용 대상