On-line справка по Win32 API

БЕСПЛАТНАЯ ежедневная online лотерея! Выигрывай каждый день БЕСПЛАТНО!

A-B-C-D-E-F-G-H-I-J-K-L-M-N-O-P-Q-R-S-T-U-V-W-X-Y-Z | Скачать

Creating the Entry-Point Function

File Manager communicates with an extension DLL through the FMExtensionProc callback function. Make sure to export this function by listing it in the EXPORTS statement of your extension's module-definition (.DEF) file. The FMExtensionProc function handles the messages listed in the preceding section by performing the tasks listed in the following table.

Task Action
Initializing the extension (FMEVENT_LOAD) Provides File Manager with the name and handle of the menu and saves the menu-item delta value.
Initializing the menu (FMEVENT_INITMENU) Initializes all top-level menu items and the items in any submenus.
Initializing the toolbar (FMEVENT_TOOLBARLOAD) Provides File Manager with information about the buttons to add to the toolbar, including the command identifier, Help string identifier, styles, and bitmap identifier.
Processing menu selections Carries out commands that the user chooses from the extension's menu.
Processing file selections (FMEVENT_SELCHANGE) Queries File Manager for information about the file that the user has selected from the directory window or Search Results window.
Updating items in the menu (FMEVENT_USER_REFRESH) Modifies the menu as appropriate when the user chooses File Manager's Refresh command from the Window menu.
Providing menu item help strings (FMEVENT_HELPSTRING) Provides File Manager with a help string for a specified command in a specified menu. File Manager displays this string in the area at the bottom left of the window.
Passing menu item help requests on to WinHelp (FMEVENT_HELPMENUITEM) Provides WinHelp with the window passed by File Manager and menu item information,
Quitting the extension DLL (FMEVENT_UNLOAD) Frees any memory allocated and prepares to exit.

The FMExtensionProc function is defined as follows.

LONG WINAPI FMExtensionProc(hwnd, wMsg, lParam)
HWND hwnd;
WORD wMsg;
LONG lParam;

The hwnd parameter identifies the File Manager window. An extension should use this window handle to specify the parent window for any dialog box or message box it must display. It should also use this handle to send query messages to File Manager. The uMsg parameter contains one of the File Manager messages listed previously. The lParam parameter contains a message-specific value. The return value from the FMExtensionProc function depends on the value of the uMsg parameter.

The menu added to File Manager may be a hierarchical (cascaded) menu and may contain grayed, disabled, or checked menu items in addition to command items. Menu items should be text only; owner-drawn menus and bitmap menus are not supported. Changing the bitmap for check marks is not supported.
Whenever File Manager calls the FMExtensionProc function, it waits to refresh its directory windows (for changes in the file system) until after the function returns. This allows the extension to perform large numbers of file operations without excessive repainting on the part of File Manager. It is not necessary for the extension to send the FM_REFRESH_WINDOWS message to notify File Manager to repaint its directory windows.

Пригласи друзей и счет твоего мобильника всегда будет положительным!

Пригласи друзей и счет твоего мобильника всегда будет положительным!

Создание Функции Entry-Point

Файловый Менеджер связывается с расширением DLL через функцию возврата FMExtensionProc. Убедитесь, чтобы экспортировать эту функцию перечисляя этому в утверждении ЭКСПОРТА вашего расширения модульное-определение (.ОПРЕДЕЛЕННЫЙ) файл. Функция FMExtensionProc оперирует сообщения указанные в предыдущей секции выполняя задачи указывался на следующем столе.

Действие Задачи
Инициализирующий расширение (FMEVENT_LOAD) Обеспечивает Файловому Менеджеру именем и ручкой меню и сохраняет меню-пункт величины дельты.
Инициализирующий меню (FMEVENT_INITMENU) Инициализирует все пункты меню верхнего уровня и пункты в любых субменю.
Инициализирующий toolbar (FMEVENT_TOOLBARLOAD) Обеспечивает Файлового Менеджера информацией о кнопках, чтобы добавлять к toolbar, включая командный идентификатор, идентификатор строки Подсказки, стилей, и идентификатор побитового отображения.
Выборы меню Обработки Carries out приказывает, чтобы пользователь выбирался из меню расширения.
Обрабатывая файловые выборы (FMEVENT_SELCHANGE) Файловый Менеджера Запросов для информации о файле, которые пользователь выбрался из окна директория или окна Результатов Поиска.
Обновление пунктов в меню (FMEVENT_USER_REFRESH) Модифицирует меню как подходящий когда пользователь выбирает команду Восстановления Файлового Менеджера из меню Окна.
Подсказка пункта меню Обеспечения строк (FMEVENT_HELPSTRING) Обеспечивает Файлового Менеджера строкой подсказки для определенной команды в определенном меню. Файловый Менеджер отображает эту строку в области внизу слева от окна.
Подсказка пункта меню Прохождения запросов на на WinHelp (FMEVENT_HELPMENUITEM), Обеспечивает WinHelp окном пройденным Файловым Менеджером и информацией пункта меню, покидающими расширение DLL (FMEVENT_UNLOAD), Освобождает любую память распределенную и готовится, чтобы выходить.

Функция FMExtensionProc определяется следующим образом.

ДОЛГО (ДЛИНОЙ) WINAPI FMExtensionProc(hwnd, wMsg, lParam) HWND hwnd;
СЛОВО wMsg;
ДОЛГО (ДЛИНОЙ) lParam;

Параметр hwnd идентифицирует Файловое окно Менеджера. Расширение должно использовать эту ручку окна, чтобы определять родительскому окну для любого диалогового блока или блока сообщения, которые он должен отобразить. Это должно также использовать эту ручку, чтобы посылать запросу сообщения Файловому Менеджеру. Параметр uMsg содержит одного из Файловых сообщений Менеджера указанных прежде. Параметр lParam содержит сообщенюю-специфическую величину. Обратная величина из функции FMExtensionProc зависит от величины параметра uMsg.

Меню добавленное к Файловому Менеджеру может быть иерархическим меню (cascaded) и может содержать grayed, выведенное из строя, или проверившее пункты меню дополнительно к командным пунктам. Пункты Меню должны быть текст только; сделанные меню владельца и меню побитового отображения не поддерживаны. Изменение побитового отображения для контрольных отметок не поддерживано.
Всякий раз, когда Файловый Менеджер вызывает функцию FMExtensionProc, он ожидается, чтобы освежать свое окно директория (для изменений в файловой системе) даже после функционального возврата. Это позволяет расширение, чтобы выполнять множество файловых операций без чрезмерного перекрашивать со стороны Файлового Менеджера. Нет необходимости для расширения, чтобы посылать сообщение FM_REFRESH_WINDOWS, чтобы уведомлять Файлового Менеджера, чтобы перекрашивать свое окно директория.

Используются технологии uCoz