UiaChangeInfo 구조체(uiautomationcore.h)

발생한 UI 자동화 변경에 대한 데이터를 포함합니다.

구문

struct UiaChangeInfo {
  int     uiaId;
  VARIANT payload;
  VARIANT extraInfo;
};

멤버

uiaId

변경 정보의 유형을 식별합니다. 가능한 값은 변경 식별자, 속성 식별자, 텍스트 특성 식별자, 주석 형식 식별자 및 스타일 식별자의 모든 값입니다.

payload

발생한 변경 유형에 대한 정보입니다.

extraInfo

발생한 변경 내용에 대한 자세한 정보입니다.

설명

공급자는 UiaRaiseChangesEvent 를 호출하고 UiaChangeInfo 구조체 배열을 전달하여 클라이언트에 관련 변경 내용 그룹을 알릴 수 있습니다. 페이로드 및 extraInfo는 UiaChangeInfo 구조체에 채워진 uiaId에 따라 달라집니다.

이러한 이벤트 유형 중 여러 가지가 있는 경우 여러 UiaChangeInfo 구조체가 만들어집니다. 다음은 각 값 쌍에 대한 설명입니다.

UiaId	payload	extraInfo
UIA_SummaryChangeId	VT_BSTR 애플리케이션 관점에서 변경의 의미를 설명하는 문자열입니다.	이 이벤트의 의미를 나타내는 공급자의 상수 ID 값입니다.
UIA 속성 변경의 경우 속성 식별자 섹션에서 식별됩니다.	형식은 속성의 형식이며 값은 속성의 새 값입니다.
텍스트 특성 식별자 섹션에서 식별된 텍스트 특성 변경의 경우 extraInfo가 사용되지 않습니다.	형식은 특성의 형식이고 값은 특성의 새 값입니다.
주석 형식 식별자 섹션에서 식별된 주석 변경의 경우 extraInfo 가 사용되지 않습니다.	VT_BSTR 텍스트의 경우 주석이 적용되는 범위의 문자입니다.
스타일 식별자 섹션에서 식별된 스타일 변경의 경우 extraInfo가 사용되지 않습니다.	VT_BSTR 텍스트의 경우 스타일이 적용되는 범위의 문자입니다.

요구 사항

요구 사항	값
헤더	uiautomationcore.h