다음을 통해 공유


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

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

구문

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

매개 변수

[in] attributeId

형식: TEXTATTRIBUTEID

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

[out, retval] pRetVal

형식: VARIANT*

다음 중 하나를 받습니다.

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

반환 값

형식: HRESULT

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

설명

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

요구 사항

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

추가 정보

개념

ITextProvider

ITextRangeProvider

참조

UI 자동화 공급자 개요