ITextRangeProvider::GetAttributeValue 메서드(uiautomationcore.h)

텍스트 범위에서 지정된 텍스트 특성의 값을 검색합니다.

구문

HRESULT GetAttributeValue(
  [in]          TEXTATTRIBUTEID attributeId,
  [out, retval] VARIANT         *pRetVal
);

[in] attributeId

형식: TEXTATTRIBUTEID

텍스트 특성의 식별자입니다. 텍스트 특성 ID 목록은 텍스트 특성 식별자를 참조하세요.

[out, retval] pRetVal

형식: VARIANT*

다음 중 하나를 받습니다.

지정된 특성의 값을 나타내는 개체의 주소입니다. 값의 데이터 형식은 지정된 특성에 따라 달라집니다. 예를 들어 attributeId 가 UIA_FontNameAttributeId경우 GetAttributeValue 는 텍스트 범위의 글꼴 이름을 나타내는 문자열을 반환하지만 attributeId 가 UIA_IsItalicAttributeId경우 GetAttributeValue 는 부울을 반환합니다.
지정된 특성의 값이 텍스트 범위에 따라 달라지는 경우 UiaGetReservedMixedAttributeValue 함수에서 검색한 값의 주소입니다.
지정된 특성이 공급자 또는 컨트롤에서 지원되지 않는 경우 UiaGetReservedNotSupportedValue 함수에서 검색한 값의 주소입니다.

이 매개 변수는 초기화되지 않은 상태로 전달됩니다.

형식: HRESULT

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

GetAttributeValue 메서드는 텍스트가 숨겨져 있는지 또는 표시되는지에 관계없이 특성 값을 검색해야 합니다.


지원되는 최소 클라이언트	Windows XP [데스크톱 앱 \| UWP 앱]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱 \| UWP 앱]
대상 플랫폼	Windows
헤더	uiautomationcore.h(UIAutomation.h 포함)