Тарас Сорока - Русский справочник по Win32 API
- Название:Русский справочник по Win32 API
- Автор:
- Жанр:
- Издательство:неизвестно
- Год:неизвестен
- ISBN:нет данных
- Рейтинг:
- Избранное:Добавить в избранное
-
Отзывы:
-
Ваша оценка:
Тарас Сорока - Русский справочник по Win32 API краткое содержание
Русский справочник по Win32 API - читать онлайн бесплатно полную версию (весь текст целиком)
Интервал:
Закладка:
Возвращаемые значения
В случае успеха возвращается ненулевое значение.
В случае неудачи возвращается нуль. Для дополнительной информации об ошибке вызовите функцию 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 ).
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 - определяет, удалять ли существующие ресурсы, находящиеся в файле, определяемом значением параметра pFileName . Если значение параметра bDeleteExistingResources равно TRUE, существующие ресурсы удаляются и обновленный исполняемый файл содержит только ресурсы, добавленные функцией UpdateResource. Если значение параметра bDeleteExistingResources равно FALSE, обновленный исполняемый файл содержит существующие ресурсы до тех пор, пока они не будут явно удалены или заменены функцией UpdateResource.
Возвращаемые значения
В случае успеха возвращается дескриптор, который может быть использован в функциях UpdateResourceи EndUpdateResource.
Возвращается NULL, если указанный файл не является исполняемым файлом, исполняемый файл уже загружен, файл не существует или файл не может быть открыт для записи. Для получения дополнительной информации об ошибке вызовите функцию GetLastError.
Читать дальшеИнтервал:
Закладка:
