На главную

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 | Скачать Вниз

LoadCursor



The LoadCursor function loads the specified cursor resource from the executable (.EXE) file associated with an application instance.

HCURSOR LoadCursor(

HINSTANCE hInstance, // handle of application instance
LPCTSTR lpCursorName // name string or cursor resource identifier
);


Parameters

hInstance

Identifies an instance of the module whose executable file contains the cursor to be loaded.

lpCursorName

Points to a null-terminated string that contains the name of the cursor resource to be loaded. Alternatively, this parameter can consist of the resource identifier in the low-order word and zero in the high-order word. The MAKEINTRESOURCE macro can also be used to create this value.

To use one of the Win32 predefined cursors, the application must set the hInstance parameter to NULL and the lpCursorName parameter to one the following values:

Value Description
IDC_APPSTARTING Standard arrow and small hourglass
IDC_ARROW Standard arrow
IDC_CROSS Crosshair
IDC_IBEAM Text I-beam
IDC_ICON Windows NT only: Empty icon
IDC_NO Slashed circle
IDC_SIZE Windows NT only: Four-pointed arrow
IDC_SIZEALL Same as IDC_SIZE
IDC_SIZENESW Double-pointed arrow pointing northeast and southwest
IDC_SIZENS Double-pointed arrow pointing north and south
IDC_SIZENWSE Double-pointed arrow pointing northwest and southeast
IDC_SIZEWE Double-pointed arrow pointing west and east
IDC_UPARROW Vertical arrow
IDC_WAIT Hourglass


Return Values

If the function succeeds, the return value is the handle of the newly loaded cursor.
If the function fails, the return value is NULL. To get extended error information, call GetLastError.

Remarks

LoadCursor only loads the cursor resource if it has not been loaded; otherwise, it retrieves the handle of the existing resource. This function returns a valid cursor handle only if the lpCursorName parameter points to a cursor resource. If lpCursorName points to any type of resource other than a cursor (such as an icon), the return value is not NULL, even though it is not a valid cursor handle.
The LoadCursor function searches the cursor resource most appropriate for the cursor for the current display device. The cursor resource can be a color or monochrome bitmap.

See Also

LoadImage, MAKEINTRESOURCE, SetCursor, SetCursorPos, ShowCursor


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

LoadCursor



Функция LoadCursor загружает определенный ресурс курсора из программы (.EXE) ФАЙЛ связывался прикладным примером.

HCURSOR LoadCursor(

hInstance HINSTANCE, // РУЧКА прикладного примера LPCTSTR lpCursorName // называют строку или идентификатор ресурса курсора
);


Параметры

hInstance

Идентифицирует пример модуля, чей выполняемый файл содержит курсор, который нужно загружаться.

lpCursorName

Точки на недействительный расторгнутую строку, которые содержат имя ресурса курсора, который нужно загружаться. Кроме того, этот параметр может состоять из идентификатора ресурса в младшем слове и нуле в старшем слове. Макро MAKEINTRESOURCE может также использовано, чтобы создавать эту величину.

Чтобы использовать один из встроенных курсоров Win32, приложение должно установить параметр hInstance в НЕДЕЙСТВИТЕЛЬНЫЙ и параметр lpCursorName, чтобы один следующее величин:

Описание Величины
стрела Стандарта IDC_APPSTARTING и небольшого Стандарта hourglass стрела IDC_ARROW Перекрестия IDC_CROSS IDC_IBEAM Text I-beam IDC_ICON Windows NT только: Пустая икона IDC_NO Урезала Окно круга IDC_SIZE NT только: Четыре-указывали стрелу IDC_SIZEALL Также, как IDC_SIZE
IDC_SIZENESW указывал стрелу Двойного количества, указывающую северо-восток и юго-запад IDC_SIZENS указывал стрелу Двойного количества, указывающую север и юг IDC_SIZENWSE указывал стрелу Двойного количества, указывающую северо-запад и юго-восток IDC_SIZEWE указывал стрелу Двойного количества, указывающую запад и Вертикальную стрелу востока IDC_UPARROW IDC_WAIT Hourglass


Обратные Величины

Если функция добивается успеха, обратная величина является ручкой вновь загруженного курсора.
Если функция терпит неудачу, обратная величина НЕДЕЙСТВИТЕЛЬНА. Для того, чтобы расширять информацию ошибки, назовите GetLastError.

Замечания

LoadCursor ТОЛЬКО загружает ресурс курсора если это не загружено; в противном случае, это извлекает ручку существующего ресурса. Эта функция возвращает правильную ручку курсора только если параметр lpCursorName указывает на ресурс курсора. Если точки lpCursorName на любой тип ресурса кроме курсора (как например, иконка), обратная величина не НЕДЕЙСТВИТЕЛЬНА, даже если она - не правильная ручка курсора.
Функция LoadCursor ищет ресурс курсора наиболее подходящий для курсора для текущего дисплейного устройства. Ресурс курсора может быть цветным или монохромным побитовым отображением.

Смотри Также

LoadImage, MAKEINTRESOURCE, SetCursor, SetCursorPos, ShowCursor


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