功能原型

【勇芳软件工作室】汉化HomePreviousNext

功能原型也在通用,ANSI和Unicode品种中提供,如下所示。通用函数原型由实现为宏的标准函数名称组成。预处理器将每个宏扩展为特定功能原型之一,具体取决于是否定义了UNICODE。字母【A】(ANSI)和【W】(宽)在特定功能原型的函数名末尾添加。在此示例中,通用原型使用通用类型LPTSTR作为文本参数,但A和W原型分别使用LPCSTRLPCWSTR字符类型。

SetWindowText(HWND hwnd, LPTSTR lpText);

SetWindowTextA(HWND hwnd, LPCSTR lpText);

SetWindowTextW(HWND hwnd, LPCWSTR lpText);

应用程序可以使用通用函数,使Unicode取决于是否使用UNICODE选项来编译代码,也可以使用以【A】【W】结尾的显式函数名称进行混合调用。

这种三原型方法适用于具有文本参数的所有函数。始终使用通用函数原型与通用字符串和字符类型。以大写【W】结尾的所有函数名称都使用宽字符参数。

某些功能仅在宽字符版本中存在,只能使用适当的数据类型。

每个支持Unicode的功能的参考资料都标有Unicode图标。如果该函数作为预处理器必须扩展为ANSI或Unicode格式的宏存在,则仅记录宏表单。

注意每当一个函数具有一个字符串的长度参数时,该长度应以字符串中的字符计数(TCHAR为单位)给出。但是,需要或返回非类型内存块的指针的函数,例如GlobalAlloc函数是异常。