共用方式為

ATL 控制項精靈

  • 發行項

更新：2007 年 11 月

這個精靈會將 ATL 控制項插入至 ATL 專案 (或具有 ATL 支援的 MFC 專案)。您可使用這個精靈來插入以下任一類型的控制項：

  • 標準控制項

  • 複合控制項

  • DHTML 控制項

除此之外，您也可以指定一個最小控制項，從介面清單移除介面，介面是預設讓控制項可以在多數容器中開啟。您可在精靈的 [介面] 頁面中設定控制項要支援的介面。

備註

從 Visual Studio 2008 開始，此精靈產生的註冊指令碼將會在 HKEY_CURRENT_USER 下 (而非 HKEY_LOCAL_MACHINE 下) 註冊它的 COM 元件。若要修改此行為，請設定 [ATL 精靈] 的 [登錄所有使用者的元件] 選項。

名稱

指定要加入專案的物件、介面和類別 (Class) 名稱。除了 [簡短名稱] 之外，其他方塊都可以單獨進行編輯。如果您變更 [簡短名稱] 當中的文字，這個頁面中所有其他方塊的名稱都將反映此變更。如果您變更 [COM] 區段中的 [Coclass] 名稱，這項變更會反映在 [型別] 和 [ProgID] 方塊中，但是 [介面] 名稱則不受影響。這項命名行為可讓您在開發控制項時能更容易識別所有的名稱。

注意事項：

Coclass 只能在未使用屬性的控制項上進行編輯。如果您的專案已經屬性化，您便無法編輯 Coclass。

C++

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

  • 簡短名稱
    設定物件的縮寫名稱。除非您針對個別欄位變更，否則您提供的名稱將決定類別和 Coclass 名稱、檔案 (.CPP 和 .H) 名稱、介面名稱、[型別] 名稱以及 ProgID。

  • Class
    設定實作物件的類別名稱。這個名稱會根據您在 [簡短名稱] 中提供的名稱來命名，並在前端加上類別名稱慣用的前置字元 'C'。

  • .h 檔案
    為新物件類別設定標頭檔 (Header File) 的名稱。根據預設，這個名稱是根據您在 [簡短名稱] 中提供的名稱來命名。按一下省略按鈕，將檔名儲存至您選擇的位置，或將類別宣告附加至現有的檔案。如果您選擇現有檔案，則要按一下 [完成] 將檔名儲存至選取的位置。

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

  • .cpp 檔
    為新物件類別設定實作檔 (Implementation File) 的名稱。根據預設，這個名稱是根據您在 [簡短名稱] 中提供的名稱來命名。按一下省略按鈕，將檔名儲存至您選擇的位置。除非您在精靈中按一下 [完成]，否則精靈不會將檔案儲存到選取位置。

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

  • 屬性化
    表示物件是否使用屬性 (Attribute)。如果您正將物件加入至屬性化的 ATL 專案，則會選取這個選項，而且無法變更。也就是說，您只能將屬性化物件加入至以屬性支援建立的專案。

    您只能將屬性化物件加入至使用屬性的 ATL 專案。如果您為沒有屬性支援的 ATL 專案選取這個選項，則精靈會提示您是否要在專案中加入屬性支援。

    根據預設，您在設定此選項之後新增的所有物件都會指定為已設定屬性 (已選取核取方塊)。您可以清除這個方塊以便加入不使用屬性的物件。

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

COM

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

  • Coclass
    設定元件類別的名稱，這個類別包含物件所支援介面的清單。

    注意事項：

    如果您使用屬性建立專案，或是在這個精靈頁面上指示控制項要使用屬性，就無法變更這個選項，因為 ATL 不包含 coclass 屬性。

  • 介面
    設定物件的介面名稱。根據預設，介面名稱的開頭都會加上 "I"。

  • 類型
    設定將出現在登錄中的物件描述。

  • ProgID
    設定容器用來代替物件 CLSID 的名稱。

請參閱

工作

加入 ATL 控制項

概念

Adding Functionality to the Composite Control

參考

Fundamentals of ATL COM Objects