CreateCaret

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

(BOOL CreateCaret HWND  hWnd, / / дескриптор окна-владельцаHBITMAPhBitmap, / / обработать рисунок для вставки фигурыintnWidth, / / ширина кареткиintnHeight / / высота каретки);
 

Параметры

hWnd
Идентифицирует окно, которому принадлежит курсора.
hBitmap
Идентифицирует точечный рисунок, который определяет форму курсора. Если этот параметр имеет значение NULL, курсор является твердой. Если этот параметр равен (HBITMAP) 1, знак вставки — Грей. Если этот параметр дескриптора точечного рисунка, курсор является указанный рисунок. Дескриптор точечного рисунка должен быть создан путем CreateBitmap CreateDIBitmap, или LoadBitmap функция.

Если hBitmap является дескриптор точечного рисунка, CreateCaret игнорирует параметры nWidth и nHeight ; точечный рисунок определяет ширину и высоту.

nWidth
Определяет ширину курсора в логических единицах. Если этот параметр равен нулю, Ширина значение ширины границы окна, определяемые системой. Если hBitmap является дескриптор точечного рисунка, CreateCaret игнорирует этот параметр.
nHeight
Определяет высоту, в логических единицах, курсора. Если этот параметр равен нулю, высота присваивается высоту границы окна, определяемые системой. Если hBitmap является дескриптор точечного рисунка, CreateCaret игнорирует этот параметр.

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

Если функция выполнена успешно, возвращаемое значение не равно нулю.

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

Примечания

Параметры nWidth и nHeight определяют ширину и высоту курсора в логических единицах; точную ширину и высоту в пикселах, зависит от режима отображения окна.

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

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

Можно получить ширину или высоту границы окна системы с помощью функции GetSystemMetrics , указав значения SM_CXBORDER и SM_CYBORDER. Использование границы ширины или высоты окна гарантирует, что курсор будет виден на экранах с высоким разрешением.

Windows CE: Windows CE не поддерживает параметр hBitmap , и оно должно быть установлено в NULL. По умолчанию Windows CE для твердых курсора.

QuickInfo

nbsp; Windows &NT: требует версии 3.1 или более поздней версии.
Windows:Требует Windows 95 или более поздней версии.
Windows CE:Требует версии 1.0 или более поздней версии.
Заголовок:Объявленные в winuser.h.
Импорта библиотеки:Использование user32.lib.

Родственные слова

Обзор знаки крышки, крышки функций, CreateBitmap CreateDIBitmap, DestroyCaret, GetSystemMetrics, HideCaret, LoadBitmap, ShowCaret

Index