CopyCursor, DrawIcon, DrawIconEx. 6 страница



 

Возвращаемые значения

 

Для продолжения перечисления функция обратного вызова должна возвращать TRUE.

Для остановки перечисления, функция обратного вызова должна возвращать FALSE.

 

Комментарии

 

EnumCodePagesProc является "заполнителем" для имени определяемой приложением функции.

EnumCodePagesProc может выполнять любые желаемые действия.

Приложение регистрирует функцию EnumCodePagesProc , передавая ее адрес в функцию EnumSystemCodePages .

Значение типа CODEPAGE _ ENUMPROC является указателем на функцию EnumCodePagesProc .

 

См. также

 

EnumSystemCodePages .

 

 

GetACP

 

 

Функция GetACP возвращает идентификатор текущей кодовой страницы ANSI для системы.

 

UINT GetACP ( VOID )

Параметры

 

Функция не имеет параметров.

 

Возвращаемые значения

 

В случае успеха возвращается идентификатор текущей кодовой страницы ANSI для системы, или идентификатор по умолчанию, если текущая кодовая страница не установлена.

 

Комментарии

 

Ниже представлены идентификаторы кодовых страниц ANSI :

 

 

 Идентификатор   Значение  
874   Тайская  
932   Японская  
936   Китайская (КНР, Сингапур)  
949   Корейская  
950   Китайская (Тайвань, Гонконг)  
1200   Юникод ( ISO 10646)  
1250   Восточноевропейская ( Windows 3.1 )  
1251   Кириллическая ( Windows 3.1 )  
1252   Latin 1( Windows 3.1; США, Западная Европа)  
1253   Греческая ( Windows 3.1 )  
1254   Турецкая ( Windows 3.1 )  
1255   Еврейская  
1256   Арабская  
1257   Балтийская  

 

См. также

 

GetCPInfo, GetOEMCP .

 

 

GetCPInfo

 

 

Функция GetCPInfo извлекает информацию о любой действительной или доступной кодовой странице.

 

BOOL GetCPInfo (

 

UINT  CodePage , // идентификатор кодовой страницы

LPCPINFO  lpCPInfo // адрес структуры для информации

);

 

Параметры

 

CodePage ‑ определяет идентификатор кодовой страницы, информация о которой извлекается. Вы можете указать идентификатор для любой установленной или доступной кодовой страницы, или вы можете указать одно из следующих предопределенных значений:

 

 

 Значение   Пояснение  
CP_ACP   Использует кодовую страницу ANSI по умолчанию.  
CP_MACCP   Использует кодовую страницу Макинтош по умолчанию.  
CP_OEMCP   Использует кодовую страницу OEM по умолчанию.  

 

lpCPInfo ‑ указатель на структуру типа CPINFO , которая получает информацию о кодовой странице.

 

Возвращаемые значения

 

В случае успеха возвращается ненулевое значение.

В случае неудачи возвращается нуль. Для получения дополнительной информации об ошибке вызовите функцию GetLastError .

 

Комментарии

 

Если кодовая страница не установлена или недоступна, GetCPInfo устанавливает значение последней ошибки в ERROR_INVALID_PARAMETER .

 

См. также

 

GetACP, GetOEMCP, CPINFO .

 

 

GetSystemDefaultLCID

 

 

Функция GetSystemDefaultLCID извлекает идентификатор системной локали по умолчанию.

 

LCID GetSystemDefaultLCID ( VOID )

Параметры

 

Функция не имеет параметров.

 

Возвращаемые значения

 

В случае успеха возвращается идентификатор системной локали по умолчанию.

 

См. также

 

GetLocaleInfo, GetUserDefaultLCID, MAKELCID .

 

 

GetThreadLocale

 

 

Функция GetThreadLocale возвращается текущую локаль вызывающего потока.

 

LCID GetThreadLocale ( VOID )

Параметры

 

Функция не имеет параметров.

 

Возвращаемые значения

 

Функция возвращает 32‑битный идентификатор локали вызывающего потока.

 

Комментарии

 

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

 

См. также

 

SetThreadLocale, GetSystemDefaultLCID, GetUserDefaultLCID .

 

 

IsValidCodePage

 

 

Функция IsValidCodePage определяет, является ли действительной указанная кодовая страница.

 

BOOL IsValidCodePage (

 

UINT  CodePage // проверяемая кодовая страница

);

 

Параметры

 

CodePage ‑ определяет кодовую страницу, подлежащую проверке. Каждая кодовая страница идентифицируется уникальным номером.

 

Возвращаемые значения

 

Если кодовая страница действительна, возвращается ненулевое значение.

Если кодовая страница недействительна, возвращается нуль. Для получения дополнительной информации об ошибке вызовите функцию GetLastError .

 

Комментарии

 

Кодовая страница действительна только в том случае, если она установлена в системе.

Ниже приведены идентификаторы кодовых страниц ОЕМ:

 

 

 Идентификатор   Пояснение  
037   EBCDIC .  
437   MS ‑ DOS (США).  
500   EBCDIC "500V1" .  
708   Арабская ( ASMO 708).  
709   Арабская ( ASMO 449+, BCON V4).  
710   Арабская (Transparent Arabic).  
720   Арабская (Transparent ASMO).  
737   Греческая (ранее 437 G ).  
775   Балтийская.  
850   MS ‑ DOS многоязыковая ( Latin I ).  
852   MS ‑ DOS восточноевропейская ( Latin II ).  
855   Кириллица IBM .  
857   Турецкая IBM .  
860   MS ‑ DOS (Португалия).  
861   MS ‑ DOS (Исландия).  
862   Еврейская.  
863   MS ‑ DOS (Французская Канада).  
864   Арабская.  
865   MS ‑ DOS скандинавская.  
866   MS ‑ DOS русская.  
869   Современная греческая IBM .  
874   Тайская.  
875   EBCDIC .  
932   Японская.  
936   Китайская (КНР, Сингапур).  
949   Корейская.  
950   Китайская (Тайвань, Гонконг).  
1026   EBCDIC.  
1200   Unicode (BMP или ISO 10646).  
1250   Windows 3.1 (Восточная Европа).  
1251   Windows 3.1 ( Кириллица ).  
1252   Windows 3.1 США (ANSI).  
1253   Греческая Windows 3.1.  
1254   Турецкая Windows 3.1.  
1255   Еврейская.  
1256   Арабская.  
1257   Балтийская.  
1361   Корейская ( Johab ).  
10000   Macintosh латинская.  
10001   Macintosh японская .  
10006   Macintosh греческая I .  
10007   Macintosh кириллическая.  
10029   Macintosh Latin 2.  
10079   Macintosh (Исландия).  
10081   Macintosh турецкая.  

 

См. также

 

GetACP, GetCPInfo, GetOEMCP .

 

 

SetThreadLocale

 

 

Функция SetThreadLocale устанавливает текущую локаль вызывающего потока.

 

BOOL SetThreadLocale (

 

LCID  Locale // идентификатор локали

);

 

Параметры

 

Locale ‑ определяет новую локаль для вызывающего потока. Значение этого параметра может быть идентификатором локали, созданным макросом MAKELCID , или одним из следующих предопределенных значений:

 

 

 Значение   Пояснение  
LOCALE_SYSTEM_DEFAULT   Системная локаль по умолчанию.  
LOCALE_USER_DEFAULT   Пользовательская локаль по умолчанию.  

 

Возвращаемые значения

 

В случае успеха возвращается ненулевое значение.

В случае неудачи возвращается нуль. Для получения дополнительной информации об ошибке вызовите функцию GetLastError .

 

Комментарии

 

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

 

См. также

 

GetThreadLocale, GetSystemDefaultLCID, GetUserDefaultLCID .

 

Курсор

 

ClipCursor

 

 

Функция ClipCursor заключает курсор в прямоугольную область на экране. Если последующая позиция курсора (установленная функцией SetCursorPos или мышью) лежит вне этой прямоугольной области, Windows автоматически устанавливает координату для сохранения курсора внутри области.

 

BOOL ClipCursor (

 

CONST RECT * lpRect // указатель на структуру с прямоугольником

);

 

Параметры

 

lprc ‑ указывает на структуру типа RECT , которая содержит экранные координаты верхнего левого и нижнего правого углов ограничивающего прямоугольника. Если значение этого параметра равно NULL, курсор свободен в перемещении по экрану.

 

Возвращаемые значения

 

В случае успеха возвращается ненулевое значение.

В случае неудачи возвращается нуль. Для получения дополнительной информации об ошибке вызовите функцию GetLastError .

 

Комментарии

 

Курсор является разделяемым ресурсом. Если приложение ограничивает перемещение курсора, оно должно освободить курсор, используя функцию ClipCursor , перед передачей управления другому приложению.

Вызывающий процесс должен иметь доступ WINSTA _ READATTRIBUTES к оконной станции ( window station ). Разъяснение термина window station смотрите в описании функции CreateWindowStation .

 

См. также

 

GetClipCursor, GetCursorPos, RECT, SetCursorPos .

 

 

CopyCursor

 

 

Функция CopyCursor копирует курсор.

 

HCURSOR CopyCursor (

 

HCURSOR  pcur // дескриптор копируемого курсора

);

 

Параметры

 

pcur ‑ идентифицирует копируемый курсор.

 

Возвращаемые значения

 

В случае успеха возвращается дескриптор курсора‑копии.

В случае неудачи возвращается NULL . Для получения дополнительной информации об ошибке вызовите функцию GetLastError .

 

Комментарии

 

CopyCursor позволяет приложению или динамически подключаемой библиотеке ( DLL ) получить дескриптор курсора, которым владеет другой модуль. Затем, если другой модуль завершил свою работу, приложение все еще будет иметь возможность использовать этот курсор.

 

См. также

 

CopyIcon, GetCursor, SetCursor, ShowCursor .

 

 

CreateCursor

 

 

Функция CreateCursor создает курсор, имеющий указанный размер, битовый шаблон и горячую точку.

 

HCURSOR CreateCursor (

 

HINSTANCE  hInst , // дескриптор экземпляра приложения

int  xHotSpot , // положение горячей точки по горизонтали

int  yHotSpot , // положение горячей точки по вертикали

int  nWidth , // ширина курсора

int  nHeight , // высота курсора

CONST VOID * pvANDPlane , // указатель на массив битовой маски И

CONST VOID * pvXORPlane // указатель на массив битовой маски ИЛИ

);

 

Параметры

 

hInst ‑ идентифицирует текущий экземпляр приложения, создающего курсор.

xHotSpot ‑ определяет положение горячей точки курсора по горизонтали.

yHotSpot ‑ определяет положение горячей точки курсора по вертикали.

nWidth ‑ определяет ширину курсора в пикселях.

nHeight ‑ определяет высоту курсора в пикселях.

pvANDplane ‑ указывает на массив байт, содержащих значения битов для битовой маски И курсора, как в аппаратно‑зависимом монохромном растровом изображении.

pvXORplane ‑ указывает на массив байт, содержащих значения битов для битовой маски ИЛИ курсора, как в аппаратно‑зависимом монохромном растровом изображении.

 

Возвращаемые значения

 

В случае успеха возвращается значение, идентифицирующее курсор.

В случае неудачи возвращается NULL . Для получения дополнительной информации об ошибке вызовите функцию GetLastError .

 

Комментарии

 

Значения параметров nWidth и nHeight должны указывать ширину и высоту, поддерживаемые текущим драйвером дисплея, потому что система не может создать курсоры других размеров. Для определения того, какие ширина и высота поддерживаются драйвером дисплея, вызовите функцию GetSystemMetrics , указав значения SM _ CXCURSOR и SM _ CYCURSOR .

Перед завершением приложение должно вызвать функцию DestroyCursor для освобождение системных ресурсов, связанных с курсором.

 

См. также

 

CreateIcon, DestroyCursor, GetModuleHandle, GetSystemMetrics, SetCursor .

 

 

DestroyCursor

 

 

Функция DestroyCursor разрушает курсор, созданный функцией CreateCursor , и освобождает память, занимаемую курсором. Не используйте функцию для разрушения курсора, который не был создан функцией CreateCursor .

 

BOOL DestroyCursor (

 

HCURSOR  hCursor // дескриптор разрушаемого курсора


Дата добавления: 2021-01-21; просмотров: 70; Мы поможем в написании вашей работы!

Поделиться с друзьями:






Мы поможем в написании ваших работ!