IUIAutomationTextRange::GetAttributeValue 메서드(uiautomationclient.h)

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

구문

HRESULT GetAttributeValue(
  [in]          TEXTATTRIBUTEID attr,
  [out, retval] VARIANT         *value
);

매개 변수

[in] attr

형식: TEXTATTRIBUTEID

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

[out, retval] value

형식: VARIANT*

지정된 특성의 값을 받습니다.

반환 값

형식: HRESULT

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

설명

이 메서드에서 검색하는 값의 형식은 attr 매개 변수에 따라 달라집니다. 예를 들어 attr 매개 변수를 UIA_FontNameAttributeId 로 설정된 GetAttributeValue를 호출하면 텍스트 범위의 글꼴 이름을 나타내는 문자열이 반환되지만 attr가 UIA_IsItalicAttributeId 설정된 GetAttributeValue를 호출하면 부울이 반환됩니다.

attr에서 지정한 특성이 지원되지 않는 경우 값 매개 변수는 IUIAutomation::ReservedNotSupportedValue 속성과 동일한 값을 받습니다.

텍스트 범위는 특정 특성에 대해 둘 이상의 값을 포함할 수 있습니다. 예를 들어 텍스트 범위에 둘 이상의 글꼴이 포함된 경우 FontName 특성에는 여러 값이 있습니다. 둘 이상의 값을 가진 특성을 혼합 특성이라고 합니다. GetAttributeValue에서 검색된 값을 UIAutomation::ReservedMixedAttributeValue 속성과 비교하여 특정 특성이 혼합 특성인지 확인할 수 있습니다.

GetAttributeValue 메서드는 텍스트가 숨겨져 있는지 또는 표시되는지에 관계없이 특성 값을 검색합니다. UIA_ IsHiddenAttributeId를 사용하여 텍스트 표시 유형을 검사.

요구 사항

지원되는 최소 클라이언트	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 포함)

추가 정보

IUIAutomationTextRange

텍스트 콘텐츠에 대한 UI 자동화 지원