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