Регистрация элементов панель управления 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-файл для их хранения, см. в статье Создание ссылок на задачи с доступом для поиска для элемента панель управления.

Связанные темы

Регистрация элементов панель управления

Регистрация исполняемых панель управления элементов