共用方式為


如何註冊可執行檔主控台專案

對於實作為.exe檔案的主控台專案,不需要特殊匯出或訊息處理。 任何.exe檔案都可以註冊為命令物件,以主控台資料夾中的進入點顯示。

此處使用範例來示範註冊需求。 此範例示範如何將名為[我的設定] 的主控台專案註冊為命令物件,使其出現在主控台視窗中。 執行命令 MyApp.exe /settings 時,也會顯示 [我的設定] 視窗。

指示

步驟 1:

產生主控台專案的 GUID。 GUID 可唯一識別主控台專案。 在此範例中, {0052D9FC-6764-4D29-A66F-2F3BD9E2BB40} 是主控台專案的 GUID。

步驟 2:

使用 GUID 作為名稱,將子機碼新增至登錄,如下所示。

HKEY_LOCAL_MACHINE
   SOFTWARE
      Microsoft
         Windows
            CurrentVersion
               Explorer
                  ControlPanel
                     NameSpace
                        {0052D9FC-6764-4D29-A66F-2F3BD9E2BB40}
                           (Default) = My Settings

Default 專案的資料只是主控台專案的REG_SZ名稱。 [預設] 專案可用於識別 GUID 專案,但這是選擇性專案。

步驟 3:

使用 GUID 作為名稱,將子機碼及其專案新增至登錄,如下所示。

HKEY_CLASSES_ROOT
   CLSID
      {0052D9FC-6764-4D29-A66F-2F3BD9E2BB40}
         (Default) = My Settings
         LocalizedString = @%ProgramFiles%\MyCorp\MyApp.exe,-9
         InfoTip = @%ProgramFiles%\MyCorp\MyApp.exe,-5
         System.ApplicationName = MyCorporation.MySettings
         System.ControlPanel.Category = 1,8
         System.Software.TasksFileUrl = %ProgramFiles%\MyCorp\MyApp\MyTaskLinks.xml
  • Default。 REG_SZ。 主控台專案的顯示名稱。

  • LocalizedString。 選擇性。 REG_SZ或REG_EXPAND_SZ。 主控台專案的當地語系化名稱模組名稱和字串資料表識別碼。 格式是 「at」 符號 (@) 後面接著包含多語系使用者介面 (MUI) 字串資料表.exe或.dll的名稱。 環境變數可用來替代路徑的一部分。 路徑和檔案名後面接著逗號 (,) 和連字號 (-) ,後面接著字串資料表中的識別碼。

    如果模組沒有字串資料表,則此專案可能只是顯示名稱字串。 如果您只使用顯示名稱字串,而不是字串資料表,則名稱不會調整為目前的顯示語言。

  • InfoTip。 REG_SZ或REG_EXPAND_SZ。 主控台專案的描述。 這項資訊會顯示在滑鼠停留在專案圖示上方時所顯示的 InfoTip 中。 語法與用於 LocalizedString 的語法相同,包括只提供字串而非字串資料表參考的選項。

  • System.ApplicationName。 REG_SZ。 專案標準名稱。 表單 control.exe /name System.ApplicationName 的命令會開啟專案,例如 。 control.exe /name MyCorporation.MySettings 如需使用Control.exe的詳細資訊,請參閱執行主控台專案

  • System.ControlPanel.Category。 REG_SZ。 值,宣告專案出現所在的主控台類別。 多個類別會以逗號分隔。 在上述範例的案例中,專案會指定 [我的設定 ] 專案應該同時出現在 [外觀] 和 [個人化 ] 和 [ 程式 ] 類別中。 如需可能的類別值,請參閱指派主控台類別

  • System.Software.TasksFileUrl。 REG_SZ或REG_EXPAND_SZ。 定義 工作連結的 XML 檔案路徑。 這可以是範例所示的直接檔案路徑,或指定為模組名稱和資源識別碼的內嵌資源,例如 「%ProgramFiles%\MyCorp\MyApp\MyApp.exe,-31」。

步驟 4:

在該相同的 GUID 子機碼下,將下列子機碼新增至登錄,以提供檔案的路徑,其中包含該檔案內的圖示和資源識別碼。

HKEY_CLASSES_ROOT
   CLSID
      {0052D9FC-6764-4D29-A66F-2F3BD9E2BB40}
         DefaultIcon
            (Default) = %ProgramFiles%\MyCorp\MyApp.exe,-2

請注意,雖然語法與稍早討論的 LocalizedString 和 InfoTip 專案類似,但不會使用 '@' 字元做為指定路徑之REG_SZ或REG_EXPAND_SZ專案中的前置詞。

步驟 5:

將下列資訊新增至登錄,以提供使用者開啟主控台時由系統呼叫的命令。

HKEY_CLASSES_ROOT
   CLSID
      {0052D9FC-6764-4D29-A66F-2F3BD9E2BB40}
         Shell
            Open
               Command
                  (Default) = [REG_EXPAND_SZ] %ProgramFiles%\MyCorp\MyApp.exe /Settings

註冊主控台專案

如何註冊 DLL 主控台專案