ITfDocumentMgr::CreateContext 方法 (msctf.h)
创建上下文对象。
语法
HRESULT CreateContext(
[in] TfClientId tidOwner,
[in] DWORD dwFlags,
[in] IUnknown *punk,
[out] ITfContext **ppic,
[out] TfEditCookie *pecTextStore
);
参数
[in] tidOwner
客户端标识符。 对于应用程序,此值由之前对 ITfThreadMgr::Activate 的调用提供。 对于文本服务,此值在文本服务 ITfTextInputProcessor::Activate 方法中提供。
[in] dwFlags
保留,必须为 0。
[in] punk
指向支持 ITextStoreACP 或 ITfContextOwnerCompositionSink 接口的 对象的指针。 此值可以为 NULL。
[out] ppic
接收上下文的 ITfContext 指针的地址。
[out] pecTextStore
指向接收新上下文的编辑 Cookie 的 TfEditCookie 值的指针。 此值标识各种方法中的上下文。
返回值
此方法可以返回其中一个值。
值 | 说明 |
---|---|
|
方法成功。 |
|
一个或多个参数无效。 |
|
发生内存分配错误。 |
|
发生了未指定的错误。 |
注解
销毁上下文或使用 ITfDocumentMgr::P op 方法从堆栈中删除上下文时,将释放对 punk 参数的所有引用。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 2000 专业版 [桌面应用 |UWP 应用] |
最低受支持的服务器 | Windows 2000 Server [桌面应用 |UWP 应用] |
目标平台 | Windows |
标头 | msctf.h |
DLL | Msctf.dll |
可再发行组件 | Windows 2000 专业版上的 TSF 1.0 |
另请参阅
ITfContextOwnerCompositionSink