|
Страница 3 из 14
BOOL GetWindowRect(HWND hWnd, LPRECT lpRect); Возвращаемое значение Ненулевое, если функция завершается успешно, и нулевое в противном случае. Дополнительную информацию об ошибке можно получить, вызвав функцию GetLastError. Аргументы hWnd - дескриптор окна.
lpRect - указатель на объект структуры RECT, содержащий экранные координаты верхнего левого и нижнего правого углов окна.
Описание Функция GetWindowRect позволяет получить координаты прямоугольника, описывающего указанное окно. Координаты окна измеряются в экранных координатах, нулевая точка которых расположена в левом верхнем углу экрана. HWND HtmlHelp(HWND hwndCaller, LPCSTR pszFile, UINT uCommand, DWORD dwData); Возвращаемое значение Дескриптор окна, в котором будет выводиться справочная информация. Аргументы hwndCaller - дескриптор окна, для которого вызывается справочная система.
pszFile - определяет файл HTML, URL, компилированный файл справочной системы HTML или определение окна (предваряемое символом '>'). Если используемая команда не предполагает использования файла или URL, может принимать нулевое значение.
uCommand - содержит выполняемую команду. Список команд приведен в примечании.
dwData - содержит информацию, используемую командой, определенной в аргументе uCommand.
Описание Данная функция используется для вывода справочной информации в формате HTML. Создаваемое ею окно справочной системы является дочерним окном того окна, дескриптор которого передан в качестве аргумента данной функции, автоматически отображается поверх родительского окна и закрывается вместе с ним. Если справочная система будет посылать сообщения, они будут направляться родительскому окну. Для создаваемого окна могут быть заданы стили, координаты, заголовок и режим отображения. Как уже говорилось выше, аргумент uCommand функции HtmlHelp определяет операцию, производимую данной функцией. Эта операция определяет тип файла, передаваемого в аргументе pszFile, и информацию, передаваемую в аргументе dwData данной функции. Список команд и содержимое аргументов приведены в таблице П2.1. Таблица П2.1. Команды функции HtmlHelp
| Команда | Описание | Содержимое аргумента pszFile | Содержимое аргумента dwData | | HH_DISPLAY_TOPIC | Выводит файл HTML. Если тип окна не определен, используется окно, определенное по умолчанию. Если окно уже выведено, файл HTML заменяет его содержимое. | Файл, URL или скомпилированный файл HTML. Если в этом аргументе присутствует символ '>' за ним следует определение типа окна, в которое будет выводиться справочная информация. | Может содержать указатель на файл, URL, скомпилированный файл HTML или имя файла в имя скомпилированном файле HTML, на который указывает аргумент pszFile. Указатель может быть нулевым. | | HH_DISPLAY_TEXT_POPUP | Выводит текст из строкового ресурса, текстовой строки или текстового файла во всплывающее окно. | Имя текстового файла или нулевое значение, если текст содержится в строковом ресурсе или объекте структуры HH_POPUP. | Указатель на объект структуры HH_POPUP. | | HH_SET_WIN_TYPE | Создает новый или изменяет существующий тип окна. | Игнорируется. | Указатель на объект структуры HH_WINTYPE. | | HH_GET_WIN_TYPE | Позволяет получить объект структуры HH_WINTYPE, связанный с типом окна. Если указанный тип окна не определен, возвращает значение 1. Если указанный тип окна определен, возвращает дескриптор окна (если окно не создано, возвращает нулевое значение). | Содержит имя окна. Это имя должно начинаться с символа '>', перед которым может располагаться имя скомпилированного файла HTML. | Адрес указателя на объект структуры PHH_WINTYPE. В полученный объект структуры нельзя вносить изменения. | | HH_GET_WIN_HANDLE | Получает дескриптор окна, связанного с указанным типом окна. Если указанный тип окна не определен, возвращает нулевое значение. | Игнорируется | Указатель на строку, содержащую имя типа окна. | | HH_SET_INFO_TYPES | Устанавливает все типы информации, которые будут выводиться в данном окне. В окне, содержащем три панели, это приведет к перерисовке навигационной панели (если она отображается). | Игнорируется | Указатель на объект структуры HH_WINTYPE. В этом объекте структуры должны быть заполнены переменные cbStruct и ainfoTypes. | | HH_SYNC | Синхронизирует оглавление в окне, содержащем три панели, с указанным URL. Эта команда используется только в окнах, не поддерживающих автоматическую синхронизацию. | Содержит имя синхронизируемого окна. | Содержит синхронизирующий URL, который может в настоящее время и не выводиться. | | HH_ADD_NAV_UI | Добавляет окно навигации в навигационную панель окна, содержащего три панели. | Указатель на функцию HhWinCallBack, поддерживающую новый UI. | Уникальный числовой идентификатор нового UI. Переключение между UI осуществляется изменением значения переменной curNavType объекта структуры HH_WINTYPE. | | HH_ADD_BUTTON | Добавляет кнопку в панель инструментов окна, содержащего три панели. | Указатель на функцию HhWinCallBack, поддерживающую новую кнопку. | Уникальный числовой идентификатор новой кнопки. | | HH_KEYWORD_LOOKUP | Производит поиск указанного ключевого слова в файле .hhk. При его обнаружении соответствующая тема выводится в указанном (или в текущем, если не указано) окне. | Если содержит нулевое значение, поиск производится в файле .hhk, связанным с текущим окном. Если содержит строку, содержащую описание окна, поиск производится в файле .hhk, связанным с данным окном. В нем же будут отображаться найденные темы. Если указан файл .hhk, то поиск будет производиться в этом файле, а отображение - в текущем окне. | Указатель на строку, содержащую одно или несколько ключевых слов, разделенных точкой с запятой (;). | |