ITextProvider::GetSelection 方法 (uiautomationcore.h)

检索表示基于文本的控件中当前选定文本的文本范围的集合。

语法

HRESULT GetSelection(
  [out, retval] SAFEARRAY **pRetVal
);

参数

[out, retval] pRetVal

类型: SAFEARRAY**

接收指向文本范围的 ITextRangeProvider 接口的指针数组的地址,每个选定文本范围对应一个。 此参数未经初始化即被传递。

返回值

类型: HRESULT

如果该方法成功,则返回 S_OK。 否则,将返回 HRESULT 错误代码。

注解

对于支持文本选择的 UI 自动化提供程序,提供程序应实现此方法并返回 ITextProvider::SupportedTextSelection 值。

如果控件仅包含所选文本的单个范围, 则 pRetVal 数组应包含单个文本范围。

如果控件包含文本插入点但未选择任何文本,则 pRetVal 数组应包含文本插入点位置) 空文本范围 (退化。

如果控件不包含所选文本,或者控件不包含文本插入点,请将 pRetVal 设置为 NULL

要求

   
最低受支持的客户端 Windows XP [桌面应用 | UWP 应用]
最低受支持的服务器 Windows Server 2003 [桌面应用 | UWP 应用]
目标平台 Windows
标头 uiautomationcore.h (包括 UIAutomation.h)

另请参阅

使用安全数组的最佳做法

概念性

ITextProvider

ITextRangeProvider

引用

UI 自动化提供程序概述