На главную

On-line справка по Win32 API

Написать письмо
БЕСПЛАТНАЯ ежедневная online лотерея! Выигрывай каждый день БЕСПЛАТНО!
Список всех статей A-B-C-D-E-F-G-H-I-J-K-L-M-N-O-P-Q-R-S-T-U-V-W-X-Y-Z | Скачать Вниз

Function Prototypes



Function prototypes are also provided in generic, ANSI, and Unicode varieties, as shown below. The generic function prototype consists of the standard function name implemented as a macro. The preprocessor expands each macro into one of the specific function prototypes, depending on whether UNICODE is defined. The letters A (ANSI) and W (wide) are added at the end of the function names in the specific function prototypes. In this example, the generic prototype uses the generic type LPTSTR for the text parameter, but the A and W prototypes use the LPCSTR and LPCWSTR character types, respectively.

SetWindowText(HWND hwnd, LPTSTR lpText);

SetWindowTextA(HWND hwnd, LPCSTR lpText);

SetWindowTextW(HWND hwnd, LPCWSTR lpText);


An application can use the generic function and make Unicode dependent on whether the UNICODE option is used to compile the code, or it can make mixed calls by using the explicit function names ending with A and W.
This three-prototype approach applies to all functions with text arguments. Always use a generic function prototype with the generic string and character types. All function names that end with an uppercase W take wide-character arguments.

Some functions exist only in wide-character versions and can be used only with the appropriate data type.
The reference material for each Unicode-enabled function is labeled with a Unicode icon. If the function exists as a macro that the preprocessor must expand into an ANSI or Unicode form, only the macro form is documented.



Note Whenever a function has a length parameter for a character string, the length should be given as a count of characters (TCHAR units) in the string. However, functions that require or return pointers to untyped memory blocks, such as the GlobalAlloc function, are exceptions.




Пригласи друзей и счет твоего мобильника всегда будет положительным!
Предыдущая статья
 
Сайт Народ.Ру Интернет
Следующая статья
Пригласи друзей и счет твоего мобильника всегда будет положительным!

Функциональные Прототипы



Функциональные прототипы также приведены в общих, ANSI, и разновидностях Уникода, как показано ниже. Общий функциональный прототип состоит из стандартного функционального имени осуществленного как макро. Препроцессор расширяет каждое макро в один из специфических функциональных прототипов, или УНИКОД определен. Письма (ANSI) и W (широкий), добавлены в конце функциональных имен в специфических функциональных прототипах. В этом примере, общий прототип использует общий тип LPTSTR для текстового параметра, но A и использование прототипов W LPCSTR и символьные типы LPCWSTR, соответственно.

SetWindowText(HWND hwnd, LPTSTR lpText);

SetWindowTextA(HWND hwnd, LPCSTR lpText);

SetWindowTextW(HWND hwnd, LPCWSTR lpText);


Приложение может использовать общую функцию и делать Уникодом зависимым от использована опция УНИКОДА, чтобы компилировать код, или это может сделать смешанными вызовами используя явные функциональные имена, заканчивающиеся с A и W. Этого трех прототип метода относится ко всем функциям с текстовыми аргументами. Всегда используйте общему функциональному прототипу с общей строкой и символьными типами. Все функционируют имена, которые заканчиваются с верхним регистром W брать широкие-символьные аргументы.

Некоторые функции существуют только в широких-символьных версиях и может использоваться только с подходящим типом данных.
Материал ссылки для каждого приспособившееся функцию Уникода помечен иконкой Уникода. Если функция существует как макро, что препроцессор должен расшириться в ANSI или форма Уникода, только макро форма подтверждена.



Примечание Всякий раз, когда функция имеет длину параметра для символьной строки, длина должна быть дана как счет символов (устройства TCHAR) в строке. Тем не менее, функции, что требовать или возвращать указатели на untyped блоки памяти, как например, функция GlobalAlloc, - исключения.




Вверх Version 1.3, Oct 26 2010 © 2007, 2010, mrhx Вверх
 mrhx software  Русский перевод OpenGL  Русский перевод Win32 API
 
Используются технологии uCoz