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 并引发模式所需事件的提供程序的帮助程序函数。 按照 TextEdit 控件模式中提供的指南进行操作，该模式描述了何时引发事件以及事件应传递给UI 自动化的有效负载。

如果没有客户端侦听特定更改类型，则不会引发任何事件。

对于每个 TextEditChangeType) ，每个更改类型 (的事件数据应包含不同的有效负载：

  • TextEditChangeType_AutoCorrect： pChangedData 应为新的更正字符串 。
  • TextEditChangeType_Composition： pChangedData 应是组合中的更新字符串，仅 (更改) 部分。
  • TextEditChangeType_CompositionFinalized： pChangedData 应为已完成合成的最终字符串， (如果取消组合或) 删除，这可能为空。

要求

要求 值
最低受支持的客户端 Windows 8.1 [桌面应用 |UWP 应用]
最低受支持的服务器 Windows Server 2012 R2 [桌面应用 |UWP 应用]
目标平台 Windows
标头 uiautomationcoreapi.h
Library Uiautomationcore.lib
DLL Uiautomationcore.dll

另请参阅

HandleTextEditTextChangedEvent

ITextEditProvider

IUIAutomation3：：AddTextEditTextChangedEventHandler

TextEdit 控件模式