CopyCursor, DrawIcon, DrawIconEx. 8 страница
);
Параметры
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 .
См. также
EndUpdateResource, UpdateResource .
FindResource
Функция FindResource определяет местоположение ресурса с указанным типом и именем в указанном модуле.
HRSRC FindResource (
HMODULE hModule , // дескриптор модуля ресурса
LPCTSTR lpName , // указатель на имя ресурса
LPCTSTR lpType // указатель на тип ресурса
|
|
);
Параметры
hModule ‑ дескриптор модуля, чей исполняемый файл содержит ресурс. Значение параметра, равное NULL, определяет дескриптор модуля, связанного с загрузочным файлом, который использовала операционная система для создания текущего процесса.
lpName ‑ определяет имя ресурса. Для дополнительной информации смотрите раздел "Комментарии".
lpType ‑ определяет тип ресурса. Для дополнительной информации смотрите раздел "Комментарии". Для стандартных типов ресурсов этот параметр может принимать одно из следующих значений:
Значение | Пояснение |
RT_ACCELERATOR | Таблица акселераторов. |
RT_ANICURSOR | Анимированный курсор. |
RT_ANIICON | Анимированная иконка. |
RT_BITMAP | Битовое изображение. |
RT_CURSOR | Зависимый от аппаратного обеспечения курсор. |
RT_DIALOG | Диалоговое окно. |
RT_FONT | Шрифт . |
RT_FONTDIR | Таблица шрифтов . |
RT_GROUP_CURSOR | Независимый от аппаратного обеспечения курсор. |
RT_GROUP_ICON | Независимая от аппаратного обеспечения иконка. |
RT_ICON | Зависимая от аппаратного обеспечения иконка. |
RT_MENU | Меню . |
RT_MESSAGETABLE | Элемент таблицы сообщений. |
RT_RCDATA | Определяемые приложением ресурсы. |
RT_STRING | Элемент таблицы строк. |
RT_VERSION | Информация о версии. |
|
|
Возвращаемые значения
В случае успеха возвращается дескриптор блока с информацией об указанном ресурсе. Для получения дескриптора ресурса передайте этот дескриптор в функцию LoadResource .
В случае неудачи возвращается NULL . Для получения дополнительной информации об ошибке вызовите функцию GetLastError .
Комментарии
Если старшее слово значения параметра lpName или lpType равно нулю, младшее слово определяет целочисленный идентификатор имени или типа указанного ресурса. В противном случае, оба значения этих параметров представляют собой длинные указатели на завершающиеся нулем строки. Если первый символ строки равен '#', оставшиеся символы представляют собой десятичное число, которое определяет целочисленный идентификатор имени или типа ресурса. Например, строка "#258" представляет собой целочисленный идентификатор 258.
Приложение может уменьшить количество памяти, необходимое ресурсу, обращаясь к нему по целочисленному идентификатору вместо имени.
Приложение может использовать FindResource для поиска ресурса любого типа, но эта функция должна быть использована только в том случае, если приложение должно иметь доступ к двоичным данным ресурсов, когда оно впоследствии вызывает функции LoadLibrary и LockResource .
Для немедленного использования ресурса приложение должно использовать одну из следующих функций для поиска и загрузки ресурса:
Функция | Действие |
FormatMessage | Загружает и форматирует элемент таблицы сообщений. |
LoadAccelerators | Загружает таблицу акселераторов. |
LoadBitmap | Загружает битовое изображение. |
LoadCursor | Загружает курсор. |
LoadIcon | Загружает иконку. |
LoadMenu | Загружает меню. |
LoadString | Загружает элемент таблицы строк. |
Например, приложение должно и c пользовать функцию LoadIcon для загрузки иконки для ее отображения на экране. Тем не менее, приложение должно использовать функции FindResource и LoadResource , если оно загружает иконку для копирования ее данных в другое приложение.
См. также
FindResourceEx, FormatMessage, LoadAccelerators, LoadBitmap, LoadCursor, LoadIcon, LoadMenu, LoadResource, LoadString, LockResource, SizeofResource .
FindResourceEx
Функция FindResourceEx определяет местоположение ресурса с указанным типом, именем и языком в указанном модуле.
HRSRC FindResourceEx (
HMODULE hModule , // дескриптор модуля ресурса
LPCTSTR lpName , // указатель на имя ресурса
LPCTSTR lpType // указатель на тип ресурса
WORD wLanguage // язык ресурса
);
Параметры
hModule ‑ дескриптор модуля, чей исполняемый файл содержит ресурс. Значение параметра, равное NULL, определяет дескриптор модуля, связанного с загрузочным файлом, который использовала операционная система для создания текущего процесса.
lpName ‑ определяет имя ресурса. Для дополнительной информации смотрите раздел "Комментарии".
lpType ‑ определяет тип ресурса. Для дополнительной информации смотрите раздел "Комментарии". Для стандартных типов ресурсов этот параметр может принимать одно из следующих значений:
Значение | Пояснение |
RT_ACCELERATOR | Таблица акселераторов. |
RT_ANICURSOR | Анимированный курсор. |
RT_ANIICON | Анимированная иконка. |
RT_BITMAP | Битовое изображение. |
RT_CURSOR | Зависимый от аппаратного обеспечения курсор. |
RT_DIALOG | Диалоговое окно. |
RT_FONT | Шрифт . |
RT_FONTDIR | Таблица шрифтов . |
RT_GROUP_CURSOR | Независимый от аппаратного обеспечения курсор. |
RT_GROUP_ICON | Независимая от аппаратного обеспечения иконка. |
RT_ICON | Зависимая от аппаратного обеспечения иконка. |
RT_MENU | Меню . |
RT_MESSAGETABLE | Элемент таблицы сообщений. |
RT_RCDATA | Определяемые приложением ресурсы. |
RT_STRING | Элемент таблицы строк. |
RT_VERSION | Информация о версии. |
wLanguage ‑ определяет язык ресурса. Если значение этого параметра равно MAKELANGID ( LANG_NEUTRAL, SUBLANG_NEUTRAL ), используется текущий язык, ассоциированный с вызывающим потоком.
Для указания языка, отличного от текущего, используйте макрос MAKELANGID .
Возвращаемые значения
В случае успеха возвращается дескриптор блока с информацией об указанном ресурсе. Для получения дескриптора ресурса передайте этот дескриптор в функцию LoadResource .
В случае неудачи возвращается NULL . Для получения дополнительной информации об ошибке вызовите функцию GetLastError .
Комментарии
Если старшее слово значения параметра lpName или lpType равно нулю, младшее слово определяет целочисленный идентификатор имени или типа указанного ресурса. В противном случае, оба значения этих параметров представляют собой длинные указатели на завершающиеся нулем строки. Если первый символ строки равен '#', оставшиеся символы представляют собой десятичное число, которое определяет целочисленный идентификатор имени или типа ресурса. Например, строка "#258" представляет собой целочисленный идентификатор 258.
Приложение может уменьшить количество памяти, необходимое ресурсу, обращаясь к нему по целочисленному идентификатору вместо имени.
Приложение может использовать FindResourceEx для поиска ресурса любого типа, но эта функция должна быть использована только в том случае, если приложение должно иметь доступ к двоичным данным ресурсов, когда оно впоследствии вызывает функции LoadLibrary и LockResource .
Для немедленного использования ресурса приложение должно использовать одну из следующих функций для поиска и загрузки ресурса:
Функция | Действие |
FormatMessage | Загружает и форматирует элемент таблицы сообщений. |
LoadAccelerators | Загружает таблицу акселераторов. |
LoadBitmap | Загружает битовое изображение. |
LoadCursor | Загружает курсор. |
LoadIcon | Загружает иконку. |
LoadMenu | Загружает меню. |
LoadString | Загружает элемент таблицы строк. |
Например, приложение должно использовать функцию LoadIcon для загрузки иконки для ее отображения на экране. Тем не менее, приложение должно использовать функции FindResource и LoadResource , если оно загружает иконку для копирования ее данных в другое приложение.
См . также
FindResource, FormatMessage, LoadAccelerators, LoadBitmap, LoadCursor, LoadIcon, LoadMenu, LoadResource, LoadString, LockResource, SizeofResource .
Пространство имен оболочки
BrowseCallbackProc
Функция BrowseCallbackProc представляет собой определяемую приложением функцию обратного вызова, используемую совместно с функцией SHBrowseForFolder . Диалоговое окно выбора папки вызывает эту функцию для уведомления о событиях. Тип BFFCALLBACK определяет указатель на эту функцию обратного вызова.
int BrowseCallbackProc (
HWND hwnd ,
UINT uMsg ,
LPARAM lParam ,
LPARAM lpData
);
Параметры
hwnd ‑ дескриптор диалогового окна. Функция обратного вызова может отправлять окну следующие сообщения:
BFFM_ENABLEOK | Разрешает кнопку ОК, если значение параметра wParam не равно нулю. В противном случае запрещает кнопку ОК. |
BFFM_SETSELECTION | Выбирает указанную папку. Значение lParam представляет собой PIDL выбираемой папки, если значение wParam равно FALSE, или путь папки в противном случае. |
BFFM _ SETSTATUSTEXT | Устанавливает текст состояния в завершающуюся нулем строку, определенную значением параметра lParam . |
uMsg ‑ идентифицирует событие. Может принимать одно из следующих значений:
BFFM_INITIALIZED | Диалоговое окно завершило инициализацию. Значение параметра lpData равно NULL . |
BFFM_SELCHANGED | Изменился выбор в диалоговом окне. lpData представляет собой указатель на список идентификаторов элемента для выбранной папки. |
lParam ‑ зависящее от сообщения значение.
lpData ‑ определяемое приложением значение, которое было указано в члене lParam структуры типа BROWSEINFO .
Возвращаемые значения
Функция возвращает нуль.
См. также
BROWSEINFO .
Дата добавления: 2021-01-21; просмотров: 54; Мы поможем в написании вашей работы! |
Мы поможем в написании ваших работ!