IUIAutomationElement::GetCachedPropertyValueEx 메서드(uiautomationclient.h)

아티클
03/03/2024

이 UI 자동화 요소의 캐시에서 속성 값을 검색하고 필요에 따라 기본값을 무시합니다.

구문

HRESULT GetCachedPropertyValueEx(
  [in]          PROPERTYID propertyId,
  [in]          BOOL       ignoreDefaultValue,
  [out, retval] VARIANT    *retVal
);

매개 변수

[in] propertyId

형식: PROPERTYID

속성의 식별자입니다. 속성 ID 목록은 속성 식별자를 참조하세요.

[in] ignoreDefaultValue

형식: BOOL

지정한 속성이 지원되지 않는 경우 기본값을 무시할지 여부를 지정하는 값입니다. 기본값을 반환하지 않을 경우 TRUE , 반환될 경우 FALSE 입니다.

[out, retval] retVal

형식: VARIANT*

속성의 값을 받습니다.

반환 값

형식: HRESULT

메서드가 성공하면 S_OK를 반환하고, 그러지 않으면 HRESULT 오류 코드를 반환합니다.

설명

이 메서드는 UI 자동화 요소의 캐시에서 지정된 속성을 검색합니다. 현재 속성을 검색하려면 IUIAutomationElement::GetCurrentPropertyValueEx를 호출합니다.

ignoreDefaultValue 매개 변수에 FALSE를 전달하는 것은 IUIAutomationElement::GetCachedPropertyValue를 호출하는 것과 같습니다.

요소 자체에 대한 Microsoft UI 자동화 공급자가 속성을 지원하는 경우 속성 값이 반환됩니다. 그렇지 않으면 ignoreDefaultValue가 FALSE이면 UI 자동화 지정된 기본값이 반환됩니다.

요청된 속성이 이전에 캐시되지 않은 경우 이 메서드는 실패 코드를 반환합니다.

double 형식의 UI 자동화 속성은 NaN(Not a Number) 값을 지원합니다. double 형식의 속성을 검색할 때 클라이언트는 _isnan 함수를 사용하여 속성이 NaN 값인지 여부를 확인할 수 있습니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 7, WINDOWS Vista SP2 및 Windows Vista용 플랫폼 업데이트, WINDOWS XP SP3 및 Windows Vista용 플랫폼 업데이트 [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 R2, Windows Server 2008 SP2 및 Windows Server 2008용 플랫폼 업데이트, Windows Server 2003 SP2 및 Windows Server 2008용 플랫폼 업데이트 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	uiautomationclient.h(UIAutomation.h 포함)