分享方式:


ATL 控制項精靈

插入ATL專案 (或具有ATL支援的MFC專案) ATL 控制件。 您可以使用此精靈來插入三種控制件的其中一種:

  • 標準控件

  • 複合控件

  • DHTML 控制件

此外,您可以指定最小控件,從 [介面 ] 清單中移除介面,這些介面會提供為控件在大部分容器中開啟的預設值。 您可以在精靈的 [介面] 頁面中設定控制項支援的介面。

備註

此精靈所產生的註冊腳本會在 HKEY_CURRENT_USER 下註冊其 COM元件,而不是HKEY_LOCAL_MACHINE。 若要修改此行為,請設定 ATL 精靈的 [為所有使用者註冊元件] 選項。

名稱

指定要新增至專案的物件、介面和類別名稱。 除了 簡短名稱之外,所有其他方塊都可以獨立變更。 如果您變更簡短名稱的文字,該變更即會反映於此頁面的所有其他方塊名稱中。 如果您在 COM 區段中變更 Coclass 名稱,變更會反映在 [類型] 方塊中,但 [介面名稱] 和 [ProgID] 不會變更。 此命名行為旨在讓您開發控制項時,能夠輕鬆地識別所有名稱。

注意

Coclass 只能在非屬性控件上編輯。 如果您的專案會使用屬性,則您無法編輯 Coclass

C++

提供建立來實作物件的 C++ 類別相關資訊。

  • 簡短名稱

    設定物件的縮寫名稱。 您提供的名稱會決定 類別和 Coclass 名稱、檔案 (。CPP 和 。除非您個別變更這些欄位,否則 H) 名稱、 介面名稱和類型 名稱。

  • 類別

    設定實作物件的類別名稱。 此名稱會以您在 [簡短名稱] 中提供的名稱為基礎,前面加上 'C',此為類別名稱的一般前置詞。

  • .h 檔案

    設定新物件類別的標頭檔名稱。 根據預設,此名稱會以您在 [簡短名稱] 中提供的名稱為基礎。 按一下省略符號按鈕,將檔案名稱儲存至您選擇的位置,或將類別宣告附加至現有的檔案。 如果您選取現有的檔案,在按兩下 [完成] 之前,精靈將不會將它儲存到選取的位置。

    精靈不會覆寫檔案。 如果您選取現有檔案的名稱,當您按一下 [完成] 時,精靈會提示您指出是否應該將類別宣告附加至檔案的內容。 按一下 [是] 可附加檔案,按一下 [否] 可返回精靈並指定另一個檔案名稱。

  • .cpp 檔案

    設定新物件類別的實作檔名稱。 根據預設,此名稱會以您在 [簡短名稱] 中提供的名稱為基礎。 按一下省略符號按鈕,將檔案名稱儲存至您選擇的位置。 在您按一下精靈中的 [完成] 之前,檔案不會儲存至選取的位置。

    精靈不會覆寫檔案。 如果您選取現有檔案的名稱,當您按一下 [完成] 時,精靈會提示您指出是否應該將類別實作附加至檔案的內容。 按一下 [是] 可附加檔案,按一下 [否] 可返回精靈並指定另一個檔案名稱。

  • 使用屬性

    指出物件是否會使用屬性。 如果您要將物件新增至屬性化的 ATL 專案,則此選項已選取且無法變更。 也就是說,您只能將屬性化的物件新增至透過屬性支援建立的專案。

    您只能將使用屬性的物件加入至使用屬性的 ATL 專案。 如果您針對不含屬性支援的 ATL 專案選取此選項,精靈會提示您指定是否要將屬性支援新增至專案。

    根據預設,在您設定此選項後加入的任何物件都會指定為使用屬性 (已選取核取方塊)。 您可以清除此方塊以加入未使用屬性的物件。

    如需詳細資訊,請參閱 應用程式設定、ATL 專案精靈屬性 的基本機制。

COM

提供物件 COM 功能的相關資訊。

  • Coclass

    設定元件類別的名稱,其中包含物件所支援的介面清單。

    注意

    如果您使用屬性建立專案,或在此精靈頁面上指出控件使用屬性,則無法變更此選項,因為 ATL 不包含 coclass 屬性。

  • 介面

    設定物件的介面名稱。 介面名稱預設會加上 「I」。。

  • 類型

    設定將出現在登錄中的物件描述

  • ProgID

    設定容器可使用的名稱,而不是物件的 CLSID。 此欄位不會自動填入。 如果您未手動填入此字段,控制項可能無法供其他工具使用。 例如,在 [插入 ActiveX 控制件] 對話框中,無法使用產生的 ProgID ActiveX 控制件。 如需對話方塊的詳細資訊,請參閱插入 ActiveX 控制項

另請參閱

ATL 控制項
將功能新增至複合控制項
ATL COM 物件的基本概念