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 포함) |