2021SC@SDUSC
文章目录
IME常用函数
BOOL WINAPI ImmGenerateMessage(
//将汉字串法发送到与当前输入法相关联的应用软件中
HIMC hIMC
);//成功为TRUE,否则为FALSE
LRESULT WINAPI ImmRequestMessage( //向应用程序发送WM_IME_REQUEST消息
HIMC hIMC, //与当前输入法相关联的应用软件的句柄
WPARAM wParam, //与WM_IME_REQUEST相关的wP
LPARAM lParam //与WM_IME_REQUEST相关的LP
);
LPINPUTCONTEXT WINAPI ImmLockIMC(
//获取当前IMC的INPUTCONTEXT结构信息,增加IMC 计数器
HIMC hIMC
);//成功返回INPUTCONTEXT 结构指针,否则为NULL
BOOL WINAPI ImmUnlockIMC( //释放IMC计数器
HIMC hIMC );//返回:如果IMC计数器被减少到0了,返回FALSE,否则为TRUE.
//注意:ImmLockIMC与ImmUnlockIMC必须成对出现,必须是相同的HIMC
HIMCC WINAPI ImmGetIMCLockCount( //取计数器值
HIMC hIMC );//如果成功返回HIMC的计数器值,否则为NULL.
HIMCC WINAPI ImmCreateIMCC( //创建INPUTCONTEXT结构的一个成员
DWORD dwSize //成员的缓冲区长度
);//如果成功返回IMC的成员句柄,否则为NULL
HIMCC WINAPI ImmDestroyIMCC( //删除IMC成员缓冲区
HIMCC hIMCC
);//如果成功返回NULL,否则等于该HIMCC.
LPVOID WINAPI ImmLockIMCC( //取IMCC缓冲地址,同时使IMCC的计数器值增加
HIMCC hIMCC );
BOOL WINAPI ImmUnlockIMCC( //递减IMCC计数器
HIMCC hIMCC );//如果IMCC的计数器值为零,则返回 FALSE,否则为TRUE.
HIMCC WINAPI ImmReSizeIMCC( //重新设置IMC的成员的缓冲区大小
HIMCC hIMCC, //IMC的成员句柄
DWORD dwSize //新缓冲区大小
);//如果成功,返回新的HIMCC,否则为 NULL.
DWORD WINAPI ImmGetIMCCSize( //取IMC成员的缓冲区大小
HIMCC hIMCC );//返回IMC成员的缓冲区大小
DWORD WINAPI ImmGetIMCCLockCount( //返回IMC计数器值
HIMCC hIMCC
);//成功返回该IMCC的计数器值,否则为0
BOOL WINAPI ImmGetHotKey( //取输入法状态键,该函数供控制面板使用
DWORD dwHotKeyID,
LPUINT lpuModifiers,
LPUINT lpuVKey,
LPHKL lphKL
)
BOOL WINAPI ImmSetHotKey( //设置输入法的热键
DWORD dwHotKeyID,
UINT uModifiers,
UINT uVKey,
hKL hKL
)
HWND WINAPI ImmCreateSoftKeyboard( //产生一个软键盘
UINT uType, //软件盘上的键码含义的定义方式
UINT hOwner, //该输入法的UI窗口
int x, //x坐标
int y //y坐标
);//成功返回软键盘的窗口句柄
BOOL WINAPI ImmDestroySoftKeyboard( //销毁软键盘
HWND hSoftKbdWnd //软键盘窗口句柄
);//成功为TRUE,法哦则为FALSE.
BOOL WINAPI ImmShowSoftKeyboard( //显示或隐藏软键盘
HWND hSoftKbdWnd, //软键盘窗口句柄
int nCmdShow //SW_HIDE=隐藏,SW_SHOWNOACTIVATE=显示
);//如构成功返回 TRUE. 否则为 FALSE.
IME 文件中的常用结构
1、IMEINFOstruct tagIMEInfo { //输入法的接口信息
DWORD dwPrivateDataSize;//用户设计的数据结构的字节数
DWORD fdwProperty; //输入法对键盘事件的相应特性
DWORD fdwConversionCaps;//当前输入法具有的功能特性,如有软键盘、标点、中西文切换等功能
DWORD fdwSentenceCaps;
DWORD fdwUICaps; // 用户界面能力:支持软键盘等
DWORD fdwSCSCaps; // 用户设置编码串的能力
DWORD fdwSelectCaps; // 输入法切换时是否使用以前输入法的模式
} IIMEINFO;
2、COMPOSITIONSTR 用于编码管理
typedef struct tagCOMPOSITIONSTR {
DWORD dwSize; //当前编码信息需要的存储空间
DWORD dwCompReadAttrLen; //读入的编码属性长度
DWORD dwCompReadAttrOffset; //读入的编码的位置
DWORD dwCompReadClsLen; //读入的子串长度
DWORD dwCompReadClsOffset; //读入的子串的位置
DWORD dwCompReadStrLen; //读入的编码长度
DWORD dwCompReadStrOffset; //读入的编码的位置
DWORD dwCompAttrLen; //编码属性长度
DWORD dwCompAttrOffset; //编码属性在内存的位置
DWORD dwCompClsLen; //编码子串长度
DWORD dwCompClsOffset; //编码子串在内存的位置
DWORD dwCompStrLen; //编码串长度
DWORD dwCompStrOffset; //编码串在内存的位置
DWORD dwCursorPos; //当前光标位置
DWORD dwDeltaStart; //被修改编码的位置
DWORD dwResultReadClsLen; //读入结果子串长度
DWORD dwResultReadClsOffset; //读入结果子串在内存的位置
DWORD dwResultReadStrLen; //读入的编码长度
DWORD dwResultReadStrOffset; //读入的编码在内存的位置
DWORD dwResultClsLen; //结果子串长度
DWORD dwResultClsOffset; //结果子串在内存的位置
DWORD dwResultStrLen; //结果串长度
DWORD dwResultStrOffset; //结果串在内存的位置
DWORD dwPrivateSize; //用户自定义数据长度
DWORD dwPrivateOffset; //用户自定义数据在内存的位置
} COMPOSITIONSTR;
3、CANDIDATEINFO 用于编码选择管理
typedef struct tagCANDIDATEINFO {
DWORD dwSize; //数据所占内存大小
DWORD dwCount; //数据个数
DWORD dwOffset[32]; //各个编码列表的内存位置
DWORD dwPrivateSize; //自定义数据尺寸
DWORD dwPrivateOffset; //缓冲区位置
} CANDIDATEINFO;
4、GUIDELINE
typedef struct tagGUIDELINE {
DWORD dwSize;
DWORD dwLevel;
DWORD dwIndex;
DWORD dwStrLen;
DWORD dwStrOffset;
DWORD dwPrivateSize;
DWORD dwPrivateOffset;
} GUIDELINE;
5、CANDIDATELIST 编码选择列表信息
typedef struct tagCANDIDATELIST {
DWORD dwSize; // 用字节表示的内存大小
DWORD dwStyle; // 列表串的取值方式
DWORD dwCount; // 当前列表个数
DWORD dwSelection; // 当前选择的列表序号
DWORD dwPageStart; // 在列表窗口中所显示的列表的起始序号
DWORD dwPageSize; // 一页显示的列表个数
DWORD dwOffset[]; // 列表数据存放区地址
} CANDIDATELIST;
6、COMPOSITIONFORM 窗口位置、大小信息:
typedef tagCOMPOSITIONFORM {
DWORD dwStyle; //管理窗口方式
POINT ptCurrentPos; //给定坐标
RECT rcArea;
}COMPOSITIONFORM;
7、CANDIDATEFORM 列表窗口信息
typedef tagCANDIDATEFORM {
DWORD dwIndex; //列表窗口序号
DWORD dwStyle; //属性:
POINT ptCurrentPos; //坐标位置
REC rcArea;
} CANDIDATEFORM;
8、INPUTCONTEXT IMC 数据存放区
typedef struct tagINPUTCONTEXT {
HWND hWnd; //使用该IMC的窗口
BOOL fOpen; //IME的打开与关闭状态
POINT ptStatusWndPos; //状态窗口的位置
POINT ptSoftKbdPos; //软键盘的位置
DWORD fdwConversion; //IME状态(活动、不活动,全角等)
DWORD fdwSentence; //编码方式
union {
LOGFONTA A;
LOGFONTW W;
} lfFont; //字体
COMPOSITIONFORM cfCompForm; //编码格式结构
CANDIDATEFORM cfCandForm[4]; //列表选择结构
HIMCC hCompStr;HIMCC hCandInfo;
HIMCC hGuideLine
HIMCC hPrivate;
DWORD dwNumMsgBuf; //存放在hMsgBuf中的消息数
HIMCC hMsgBuf; //存放的消息
DWORD fdwInit //系统根据此值来初始本结构相应的信息
DWORD dwReserve[3]; //未定义
} INPUTCONTEXT;