Регистрация элементов панель управления DLL
Примечание
В текущих рекомендациях по реализации указано, что новые элементы панель управления должны быть реализованы как .exe файлы, а не .cpl файлы. Следующие сведения включаются в основном для устаревших целей.
панель управления элементы, реализованные в библиотеке DLL, которая экспортирует функцию CPlApplet, имеют требования к регистрации, отличные от требований к .exe файлам. В Windows XP новые библиотеки DLL элементов панель управления должны быть установлены в папке связанного приложения в папке Program Files. Элементы, хранящиеся в каталоге System32 с расширением .cpl, регистрировать не нужно; они автоматически отображаются в панель управления. Все остальные элементы панель управления, использующие CPlApplet, должны быть зарегистрированы одним из двух способов:
- Если элемент панель управления должен быть доступен для всех пользователей, зарегистрируйте путь для каждого компьютера, добавив значение REG_EXPAND_SZ в подраздел HKEY_LOCAL_MACHINE\Software\Microsoft\Windows\CurrentVersion\панель управления\Cpls, задал путь dll.
- Если элемент панель управления должен быть доступен для каждого пользователя, используйте HKEY_CURRENT_USER в качестве корневого ключа вместо HKEY_LOCAL_MACHINE.
В следующих двух примерах регистрируется элемент MyCplApp панель управления. Библиотека DLL называется MyCpl.cpl и находится в каталоге приложения MyCorp\MyApp . В этом первом примере показана регистрация для каждого компьютера.
Инструкции
Шаг 1.
Добавьте эти сведения в реестр, чтобы зарегистрировать существование файла .cpl.
HKEY_LOCAL_MACHINE
Software
Microsoft
Windows
CurrentVersion
Control Panel
Cpls
MyCpl = [REG_EXPAND_SZ] %ProgramFiles%\MyCorp\MyApp\MyCpl.cpl
Шаг 2.
Windows Vista и более поздних версий: Добавьте эти дополнительные сведения в реестр, чтобы указать GUID для элемента панель управления.
HKEY_LOCAL_MACHINE
Software
Microsoft
Windows
CurrentVersion
Control Panel
Extended Properties
System.Software.AppId
%ProgramFiles%\MyCorp\MyApp\MyCpl.cpl = {A newly generated GUID}
Создав GUID для уникальной идентификации элемента панель управления, можно добавить ссылки на задачи в панель управления. Без этого GUID невозможно связать связи задач с элементом панель управления. См. статью Создание ссылок на задачи, доступные для поиска, для элемента панель управления.
Шаг 3.
Windows Vista и более поздних версий: Добавьте следующие сведения в реестр, чтобы создать каноническое имя элемента.
HKEY_LOCAL_MACHINE
Software
Microsoft
Windows
CurrentVersion
Control Panel
Extended Properties
System.ApplicationName
%ProgramFiles%\MyCorp\MyApp\MyCpl.cpl = [REG_SZ] MyCorporation.MyCpl
Добавив каноническое имя, пользователи могут запустить элемент панель управления из командной строки, введя control.exe /name MyCorporation.MyCpl. Это также позволяет позже изменить реализацию с файла .cpl на файл .exe, не требуя от вызывающих программ каких-либо изменений, так как они могут продолжать открывать элемент через его каноническое имя. Дополнительные сведения о канонических именах см. в разделе Выполнение элементов панель управления.
Шаг 4.
Windows Vista и более поздних версий: Добавьте следующие сведения в реестр, чтобы назначить элемент панель управления одной или нескольким категориям.
HKEY_LOCAL_MACHINE
Software
Microsoft
Windows
CurrentVersion
Control Panel
Extended Properties
System.ControlPanel.Category
%ProgramFiles%\MyCorp\MyApp\MyCpl.cpl = [REG_DWORD] 3
Windows XP: Добавьте следующие сведения в реестр, чтобы назначить элемент панель управления одной или нескольким категориям.
HKEY_LOCAL_MACHINE
Software
Microsoft
Windows
CurrentVersion
Control Panel
Extended Properties
{305CA226-D286-468e-B848-2B2E8E697B74} 2
%ProgramFiles%\MyCorp\MyApp\MyCpl.cpl = [REG_DWORD] 3
В этом примере элемент назначается категории 3( Сеть и Интернет). Чтобы добавить элемент в несколько категорий, укажите список в виде REG_SZ значения, разделенного запятыми, например "3,8". Значения могут быть указаны в виде десятичных или шестнадцатеричных значений. Обратите внимание, что возможность добавления элемента в несколько категорий доступна только в Windows XP с пакетом обновления 2 (SP2) и более поздних версий. Все возможные значения см. в разделе Назначение категорий панель управления.
Шаг 5.
Windows Vista и более поздних версий: Добавьте в реестр следующие сведения, чтобы создать XML-файл и указать его для хранения ссылок на задачи для элемента. Значение должно быть REG_SZ путем, как показано здесь, или модулем и идентификатором ресурса (например, "C:\Program Files\MyCorp\MyApp\MyApp.exe,-31"), если это внедренный ресурс. Расположение XML-файла должно быть полностью указано. Он не может использовать переменную среды, например %ProgramFiles%.
HKEY_LOCAL_MACHINE
Software
Microsoft
Windows
CurrentVersion
Control Panel
Extended Properties
System.Software.TasksFileUrl
%ProgramFiles%\MyCorp\MyApp\MyCpl.cpl = [REG_SZ] C:\ProgramFiles\MyCorp\MyApp\MyTasks.xml
Дополнительные сведения о ссылках на задачи и о том, как создать XML-файл для их хранения, см. в статье Создание ссылок на задачи с доступом для поиска для элемента панель управления.
Связанные темы