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

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

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 ).

Windows 95:

Значение параметра игнорируется.

Windows NT :

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

Windows 95:

Значение параметра игнорируется.

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

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

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

Комментарии

Windows 95: функция Beep игнорирует значения параметров dwFreq и dwDuration . На компьютерах со звуковой картой функция воспроизводит звуковое событие по умолчанию. На компьютерах без звуковой карты функция воспроизводит стандартный системный звук через динамик компьютера.

См. также

MessageBeep .

Ресурсы

BeginUpdateResource

Функция BeginUpdateResource возвращает дескриптор, который может быть использован функцией UpdateResource для добавления, удаления или замены ресурсов в исполняемом файле.

HANDLE BeginUpdateResource (

LPCTSTR pFileName , // имя файла, в котором будут обновляться ресурсы

BOOL bDeleteExistingResources // опция удаления

);

Параметры

pFileName– указатель на завершающуюся нулем строку, которая определяет исполняемый файл, в котором необходимо обновить ресурсы. Приложение должно иметь возможность получить разрешение на запись в файл; оно не может выполняться в этот момент. Если значение pFileName не определяет полный путь, Windows ищет файл в текущей директории.