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

  • 發行項

對於實作為.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 主控台專案