Как создать расширение оболочки Context menu

Процедура инициализации обработчика, вызывается один раз при создании экземпляра обработчика.

Если создаваемое расширение не содержит пункта меню по умолчанию, то можно оптимизировать работу Windows, установив в этом методе значение свойства MayChangeDefaultMenu в значение False.

Процедура вызывается при завершении работы с текущим списком файлов, переданных в обработчик. Может вызываться дважды, см. ниже.

Функция должна возвращать уникальный идентификатор обработчика. Библиотека Shell Ace изначально генерирует уникальный идентификатор при генерации шаблона обработчика, поэтому менять его нет необходимости.

Функция должна возвращать описание обработчика.

В процедуре должно происходить заполнение списка AList ключами реестра, в которые будет прописан обработчик при регистрации расширения. Регистрация происходит в раздел реестра HKEY_CLASSES_ROOT. Например, если будет добавлен ключ .bmp и будет соответствовать всем файлам, имеющим расширение bmp, то расширение будет прописано в ветку HKEY_CLASSES_ROOT\.bmp\ShellEx\ContextMenuHandlers, а если будет добавлен ключ SystemFileAssociations\Audio, то расширение будет прописано в ветку HKEY_CLASSES_ROOT\SystemFileAssociations\Audio\ShellEx\ContextMenuHandlers и будет соответствовать всем файлам, расширения которых имеют PerceivedType Audio.

Примеры ключей реестра:

В общем случае рекомендуется регистрировать расширение на ProgID расширения файла.

Процедура должна создать дерево пунктов меню, включая вложенные в подменю. Процедура вызывается в реализации метода QueryContextMenu интерфейса IContextMenu.

Для формирования меню можно дополнительно анализировать флаги AFlags. Тип TdecContextMenuFlags определен следующим образом:

TdecContextMenuFlag = (cmfDefaultOnly, cmfVerbsOnly, cmfExplorer, cmfNoVerbs, cmfNoDefault, cmfItemMenu, cmfExtendedVerbs, cmfDisabledVerbs, cmfAsyncVerbState, cmfOptinizaForInvoke, cmfSyncCascadeMenu, cmfDoNotPickDefault);

TdecContextMenuFlags = set of TdecContextMenuFlag;

Каждый из элементов множества соответствует соответствующему флагу, переданному в метод QueryContextMenu:

Добавление пункта происходит путем вызова метода Add объекта AMenu, который возвращает объект класса TdecMenuItem:

var MenuItem: TdecMenuItem;

MenuItem := AMenu.Add(CommandID, 'Caption');

где CommandID является уникальным в рамках данного обработчика идентификатором команды, а Caption является текстом, который будет выводиться в пункте меню. После добавления пункта он должен быть инициализирован путем присвоения свойствам нужных значений. Доступны следующие свойства:

Наименование	Описание
Caption: UnicodeString	Определяет текст, который будет выводиться в пункте меню.
Help: UnicodeString	Определяет описание команды, которое будет выводится в строке статуса. Также данная строка используется в качестве всплывающей подсказки при добавлении данной команды в панель инструментов программы Проводник.
Verb: UnicodeString	Определяет сокращенное название действия, например, print или open. Используется при поиске команды при открытии файла программно.
Icon: HICON	Определяет иконку, которая будет отображаться в данном пункте меню.
IconFileName: UnicodeString	В случае, если свойство Icon не определено (равно нулю), то определяет имя файла и индекс ресурса, в котором содержится иконка, которая будет отображаться в данном пункте меню. Для определения иконки рекомендуется использовать данное свойство, а не свойство Icon, поскольку это позволит программе Проводник отображать иконку команды при добавлении ее в панель инструментов.
AutoIconSize: Boolean	Определяет, что размеры иконки элемента меню будут автоматически увеличиваться или уменьшаться до размеров, определенных системой. По умолчанию значение свойства установлено в True, менять его не рекомендуется. Свойство проявляет себя в нестандартных визуальных темах оформления, в которых размер шрифта в меню больше или меньше стандартного, или при увеличенном DPI экрана. Так выглядит меню с добавленными пунктами Register и Unregister при стандартном DPI, равном 96: Так выглядит меню при увеличенном DPI, равном 150, с AutoIconSize равном False: А так выглядит меню при увеличенном DPI, равном 150, с AutoIconSize равном True:
Default: Boolean	Определяет, что данный пункт меню является пунктом меню по умолчанию, при прорисовке выделяется утолщенным шрифтом. Только один пункт меню может являться пунктом меню по умолчанию. Если иное расширение оболочки раньше создало пункт меню по умолчанию, то данное свойство будет проигнорировано.
Enabled: Boolean	Определяет, что данный пункт меню разрешен для вызова. По умолчанию имеет значение True.
Visible: Boolean	Определяет, что данный пункт меню является видимым. По умолчанию имеет значение True.
Checked: Boolean	Определяет, что пункт меню будет отмечен галочкой.
RadioCheck: Boolean	Определяет, что в случае, если свойство Checked равно True, то вместо галочки будет использоваться точка.
OwnerDraw: Boolean	Определяет, что пункт меню имеет программную прорисовку, при этом должны быть реализованы методы GetItemSize и DrawItem. При использовании программной прорисовки Windows Vista и более современные системы будут игнорировать текущую визуальную тему и будут прорисовывать меню в классическом стиле. Так выглядит контекстное меню, прорисованное с использованием визуальной темы: А так выглядит контекстное меню с добавленным пунктом, имеющим программную прорисовку:

Добавление пунктов по вложенные меню происходит при вызове метода Add свойства SubMenu:

MenuItem2 := MenuItem.SubMenu.Add(CommandID2);

Построение меню может происходить в зависимости от количества или типа файлов, переданных в обработчик. Список переданных файлов можно получить вызовом метода CreateCurrentFileList. Функция возвращает объект класса TStrings, содержащий список файлов. В версиях Delphi вплоть до версии 2009, в которых тип string равен типу AnsiString, имена файлов в списке хранятся в формате UTF8. Объект должен быть уничтожен после его обработки. Также доступны функции GetCurrentFileListCount, которая возвращает количество файлов, и GetFirstOfCurrentFileList, которая возвращает первый элемент списка (с нулевым индексом).

Функция должна вернуть идентификатор (handle) иконки, которая будет ассоциирована с пунктом меню, в случае отсутствия иконки Функция должна вернуть 0. Значение свойства AMenuItem.ID определяет, для какого пункта меню нужно создать иконку.

Параметр AIconSize определяет рекомендуемые размеры иконки.

Для пунктов меню, имеющих свойство AutoIconSize равное True можно создать иконку любого размера, ее размер при прорисовке будет изменет автоматически до рекомендованного Windows.

Необходимости удалять иконку из памяти нет, поскольку по окончанию работы с иконкой библиотека Shell Ace сама удалит все ресурсы, связанные с иконкой.

В ОС Windows XP и более ранних версиях Windows иконка не может быть ассоциирована с пунктами меню, имеющими вложенные меню. В Windows Vista и более современных системах эта проблема отсутствует.

Если у вас в среде разработки установлен пакет Graphics32, то при использовании иконок в контекстном меню рекомендуется добавлять в проект модуль decShellExtensionGraphics32. Это позволит обработчику использовать более плавные процедуры сглаживания иконок при увеличении или уменьшении их размеров. Это проявляется при прорисовках пунктов меню с иконками и свойством AutoIconSize равным True в режимах работы с увеличенным DPI экрана.

Так выглядит меню с добавленными пунктами Register и Unregister при увеличенном DPI, равном 150, с AutoIconSize равном True без использования модуля decShellExtensionGraphics32:

А так выглядит меню при увеличенном DPI, равном 150, с AutoIconSize равном True с использованием модуля decShellExtensionGraphics32:

Если библиотека Shell Ace обнаружит установленный пакет Graphics32, то модуль decShellExtensionGraphics32 будет автоматически добавлен в список используемых модулей при создании каркаса обработчика.

Метод вызывается для определения размеров пунктов меню, имеющих режим DrawMode равный dmCustom. Значение свойства AMenuItem.ID определяет, размеры какого именно пункта меню нужно определить.

Метод вызывается для прорисовки пунктов меню, имеющих режим DrawMode равный dmCustom. Свойство AMenuItem.ID определяет, какой именно пункта меню нужно прорисовать. Библиотека Shell Ace самостоятельно отрисовывает фон пункта меню в соответствии с цветовой схемой, используемой в системе.

Параметр ADC определяет контекст, в котором нужно рисовать. Параметр ARect определяет положение и размеры области, отведенной для пункта меню. Размеры области могут быть больше или меньше, чем полученные в функции GetItemSize. Параметр ADrawState определяет стиль, в котором нужно прорисовать пункт меню.

Функция вызывается при выборе пользователем пункта меню, свойство AMenuItem.ID определяет, какой именно пункта меню был выбран. В этой функции необходимо реализовать непосредственное выполнение команды. В параметре AInfo передаются ссылка на запись, которая может использоваться при вызове системной функции ShellExecuteExW. Нижеперечисленные поля записи могут быть инициализированы, остальные поля содержат значение 0:

ATitle определяет строку, которая может использоваться запускаемым приложением в качестве заголовок главного окна, начиная с Windows Vista не используется. AShiftState определяет состояние клавиш Alt, Ctrl и Shift. Указатель APoint указывает на абсолютные координаты мыши в момент вызова команды пользователем, может быть равен nil.

Список файлов для обработки НУЖНО получать методом CreateCurrentFileList, поскольку он может отличаться в большую сторону от того списка, который был получен в методе CreateMenu. Это происходит потому, что при вызове пользователем меню для большого количества файлов Windows для создания меню передает лишь часть списка, а уже при вызове команды передает весь список. Поэтому НЕ кэшируйте список, а всегда вызывайте функцию CreateCurrentFileList повторно!