Русский справочник по Win32 API - страница 22

Шрифт
Интервал

стр.

содержимым курсора, определенным значением параметра 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 ищет файл в текущей директории.

bDeleteExistingResources - определяет, удалять ли существующие ресурсы, находящиеся в файле, определяемом значением параметра


стр.

Похожие книги