ITfInsertAtSelection：：InsertTextAtSelection 方法 (msctf.h)

  • 项目

在所选内容或插入点插入文本。

语法

HRESULT InsertTextAtSelection(
  [in]  TfEditCookie ec,
  [in]  DWORD        dwFlags,
  [in]  const WCHAR  *pchText,
  [in]  LONG         cch,
  [out] ITfRange     **ppRange
);

参数

[in] ec

标识编辑上下文。 这是从 ITfDocumentMgr：：CreateContext 或 ITfEditSession：:D oEditSession 获取的。

[in] dwFlags

具有以下值之一的位字段。

值 含义
TF_IAS_NOQUERY
 ppRange 为 NULL。 此标志不能与 TF_IAS_QUERYONLY 标志组合使用。
TF_IAS_QUERYONLY
 上下文不会修改，但 ppRange 的设置就像插入已发生一样。 只读访问权限就足够了。 如果未设置此标志， 则 ec 必须具有读/写访问权限。 此标志不能与TF_IAS_NOQUERY标志组合使用。
TF_IAS_NO_DEFAULT_COMPOSITION
 如果需要组合，则管理器不会创建默认组合。 调用方必须在释放上下文锁之前创建一个包含插入文本的合成对象。

[in] pchText

指定要插入的文本。

[in] cch

指定 pchText 中文本的字符计数。

[out] ppRange

接收插入的对象的位置。

返回值

此方法可以返回其中一个值。

值 说明
S_OK
 方法成功。
TF_E_NOLOCK
 文本服务没有文档锁
TF_E_DISCONNECTED
 上下文对象不在文档堆栈上。
TS_E_NOSELECTION
 上下文没有选择。
TS_E_READONLY
 所选内容是只读的。

注解

若要插入 IDataObject 对象而不是文本，请使用 ITfInsertAtSelection：：InsertEmbeddedAtSelection。

要求

要求 值
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 msctf.h
DLL Msctf.dll
可再发行组件 Windows 2000 专业版上的 TSF 1.0

另请参阅

IDataObject

ITfDocumentMgr：：CreateContext

ITfEditSession：:D oEditSession

ITfInsertAtSelection

ITfInsertAtSelection：：InsertEmbeddedAtSelection