UiaRaiseTextEditTextChangedEvent 함수(uiautomationcoreapi.h)

공급자가 텍스트 컨트롤에 프로그래밍 방식으로 변경된 텍스트가 있음을 Microsoft UI 자동화 코어에 알리기 위해 호출됩니다.

구문

HRESULT UiaRaiseTextEditTextChangedEvent(
  [in] IRawElementProviderSimple *pProvider,
  [in] TextEditChangeType        textEditChangeType,
  [in] SAFEARRAY                 *pChangedData
);

매개 변수

[in] pProvider

형식: IRawElementProviderSimple*

텍스트 변경이 발생한 공급자 노드입니다.

[in] textEditChangeType

형식: TextEditChangeType

발생한 텍스트 편집 변경의 유형입니다.

[in] pChangedData

형식: SAFEARRAY*

이벤트 데이터입니다. VT_BSTR 형식의 VAR로 할당할 수 있어야 합니다.

반환 값

형식: HRESULT

이 함수가 성공하면 S_OK 반환합니다. 그러지 않으면 HRESULT 오류 코드를 반환합니다.

설명

ITextEditProvider를 구현하고 패턴의 필수 이벤트를 발생시키는 공급자를 위한 도우미 함수입니다. 이벤트를 발생시키는 시기와 이벤트가 UI 자동화 전달해야 하는 페이로드를 설명하는 TextEdit 컨트롤 패턴에 제공된 지침을 따릅니다.

특정 변경 유형을 수신 대기하는 클라이언트가 없으면 이벤트가 발생하지 않습니다.

이벤트 데이터에는 각 변경 유형( TextEditChangeType당)에 대해 서로 다른 페이로드가 포함되어야 합니다.

• TextEditChangeType_AutoCorrect: pChangedData 는 수정된 새 문자열 이어야 합니다.
• TextEditChangeType_Composition: pChangedData 는 컴퍼지션에서 업데이트된 문자열이어야 합니다(변경된 부분만).
• TextEditChangeType_CompositionFinalized: pChangedData 는 완료된 컴퍼지션의 최종 문자열이어야 합니다(컴퍼지션이 취소되거나 삭제된 경우 비어 있을 수 있음).

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 8.1 [데스크톱 앱 | UWP 앱]
지원되는 최소 서버	Windows Server 2012 R2 [데스크톱 앱 | UWP 앱]
대상 플랫폼	Windows
헤더	uiautomationcoreapi.h
라이브러리	Uiautomationcore.lib
DLL	Uiautomationcore.dll

추가 정보

HandleTextEditTextChangedEvent

ITextEditProvider

IUIAutomation3::AddTextEditTextChangedEventHandler

TextEdit 컨트롤 패턴