Русский справочник по Win32 API

Параметры

X - определяет новую x -координату курсора в экранных координатах.

Y - определяет новую y -координату курсора в экранных координатах.

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

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

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

Комментарии

Курсор является разделяемым ресурсом. Окно должно перемещать курсор, только если он находится в его клиентской области.

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

См. также

ClipCursor, GetCursorPos, SetCaretPos, SetCursor, ShowCursor .

SetSystemCursor

Функция SetSystemCursor заменяет содержимое системного курсора с указанным id содержимым курсора, определенным значением параметра hcur и затем разрушает hcur . Эта функция позволяет приложению изменять системные курсоры.

BOOL SetSystemCursor (

HCURSOR hcur , // устанавливает указанный системный курсор в содержимое

// данного курсора, а затем разрушает этот курсор

DWORD id // системный курсор, заданный его идентификатором

);

Параметры

hcur - дескриптор курсора. Функция заменяет содержимое системного курсора с указанным id содержимым курсора, определенным значением параметра hcur и затем разрушает hcur , вызывая DestroyCursor ( hcur ).

id - идентификатор системного курсора.

Ниже приведен список идентификаторов системных курсоров:

Значение	Описание
OCR _ NORMAL	Обычный курсор-стрелка.
OCR _ IBEAM	Курсор в виде буквы " I ".
OCR _ WAIT	Курсор "большие песочные часы".
OCR _ CROSS	Курсор-перекрестие.
OCR _ UP	Курсор "стрелка вверх".
OCR _ SIZE	Курсор изменения размеров.
OCR _ ICON	Курсор-иконка.
OCR _ SIZENWSE	Курсор изменения размера. Ориентирован с северо-запада на юго-восток.
OCR _ SIZENESW	Курсор изменения размера. Ориентирован с северо-востока на юго-запад.
OCR_SIZEWE	Горизонтальный курсор изменения размера.
OCR _ SIZENS	Вертикальный курсор изменения размера.
OCR _ SIZEALL	Курсор изменения всех размеров. То же, что и OCR _ SIZE.
OCR_SIZENO	Курсор международного символа запрещения, отрицания.
OCR _ APPSTARTING	Курсор "маленькие песочные часы со стрелкой".

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

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

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

См. также

DestroyCursor, LoadCursor, LoadCursorFromFile, SetCursor .

ShowCursor

Функция ShowCursor отображает или скрывает курсор.

int ShowCursor (

BOOL bShow // флаг видимости курсора

);

Параметры

bShow - определяет, инкрементируется или декрементируется внутренний счетчик отображения. Если значение bShow равно TRUE - внутренний счетчик отображения увеличивается на единицу. Если значение bShow равно FALSE - внутренний счетчик отображения уменьшается на единицу.

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

Возвращаемое значение определяет новый счетчик отображения.

Комментарии

Функция устанавливает внутренний счетчик, определяющий, должен ли быть отображен курсор. Курсор отображается лишь в том случае, если счетчик отображения больше нуля или равен нулю. Если в системе установлена мышь, то начальное значение счетчика равно 0. Если мышь в системе не установлена, начальное значение счетчика равно -1.

См. также

ClipCursor, GetCursorPos, SetCursor, SetCursorPos .

Ошибки

Beep

Функция Beep генерирует простые звуки на динамике компьютера. Функция синхронная; она не возвращает управления до тех пор, пока звук не прекратится.

BOOL Beep (

DWORD dwFreq , // частота звука в герцах

DWORD dwDuration // продолжительность звука в миллисекундах

);

Параметры

Windows NT :

dwFreq - определяет частоту звука в герцах. Значение параметра должно лежать в диапазоне от 37 до 32,767 (0 x 25 до 0 x 7 FFF ).