加入控制項 (ATL 教學課程，第 2 部分)

在此步驟中，您會將控制項新增至專案、建置控制項，並在網頁上進行測試。

程序

將物件加入 ATL 專案

1. 在 [方案總管] 中，以滑鼠右鍵按一下 Polygon 專案。

2. 指向快捷方式功能表上的 [ 新增 ]，然後按一下子功能表中的 [ 新增專案 ]。

   [加入新項目] 對話方塊隨即出現。 不同的物件類別會列在左側的樹狀結構中。

3. 按一下 ATL 資料夾。

4. 從右側的範本清單中，選取 [ATL 控制項 ]。 按一下新增。 ATL 控制項 精靈隨即開啟，您可以設定控制項。

5. 輸入 PolyCtl 作為簡短名稱，並注意其他欄位會自動完成。 請勿按一下 [完成 ]，因為您必須進行一些更多變更。

ATL 控制項 精靈的 [名稱 ] 頁面包含下欄欄位：

欄位	目錄
簡短名稱	您為控制項輸入的名稱。
類別	建立以實作 控制項的 C++ 類別名稱。
.h 檔案	建立以包含 C++ 類別定義的檔案。
.cpp 檔案	建立的檔案包含 C++ 類別的實作。
CoClass	這個控制項的元件類別名稱。
介面	控制項將在其上實作其自訂方法和屬性的介面名稱。
類型	控制項的描述。
ProgID	可用來查閱控制項 CLSID 的可讀取名稱。

您會發現 ATL 控制項 精靈中 必須變更數個額外的設定。

啟用豐富錯誤資訊和連接點的支援

1. 按一下 [ 選項 ] 以開啟 [ 選項] 頁面。

2. 選取 [連線點] 核取方塊。 此選項會在 IDL 檔案中建立傳出介面的支援。

您也可以新增介面來擴充控制項的功能。

擴充控制項的功能

1. 按一下 [ 介面 ] 以開啟 [ 介面] 頁面。

2. 選取 IProvideClassInfo2 並按一下 向上 箭號，將它 移至 [支援] 清單。

3. 選取 ISpecifyPropertyPages 並按一下 向上 箭號，將它 移至 [支援] 清單。

您也可以讓控制項 可 插入，這表示它可內嵌至支援内嵌物件的應用程式，例如 Excel 或 Word。

若要讓控制項可插入

1. 按一下 [外觀 ] 以開啟 [ 外觀] 頁面。

2. 選取 [ 可插入] 核取方塊。

物件所顯示的多邊形會有純色填滿色彩，因此您必須新增 Fill Color 股票屬性。

若要新增填滿色彩庫存屬性並建立控制項

1. 按一下 [ 股票屬性 ] 以開啟 [股票屬性] 頁面。

2. 在 [不支援] 下 ，向下捲動可能的股票屬性清單。 選取 Fill Color 並按一下 向上 箭號，將它 移至 [支援] 清單。

3. 選擇 [完成]。

當精靈建立 控制項時，會發生數個程式碼變更和檔案新增。 系統會建立下列檔案：

檔案	說明
PolyCtl.h	包含 C++ 類別 CPolyCtl 的大部分實作。
PolyCtl.cpp	包含 的 CPolyCtl 其餘部分。
PolyCtl.rgs	文字檔，其中包含用來註冊控制項的登入指令檔。
PolyCtl.htm	包含新建立控制項參考的網頁。

精靈也會進行下列程式碼變更：

• #include將 語句新增至先行編譯標頭檔，以包含支援控制項所需的 ATL 檔案。

• 變更 Polygon.idl 以包含新控制項的詳細資料。

• 將新的控制項新增至 Polygon.cpp 中的物件對應。

現在您可以建置控制項來查看其運作情形。

建置和測試控制項

建置和測試控制項

1. 在 [建置 ] 功能表上，按一下 [建置多邊形 ]。

   控制項完成建置之後，以滑鼠右鍵按一下 方案總管 中的 PolyCtl.htm，然後選取 [在瀏覽器中 檢 視]。 會顯示包含控制項的 HTML 網頁。 您應該會看到標題為 「ATL 8.0 test page for object PolyCtl」 的頁面，以及控制項 PolyCtl 文字。

注意

如果看不到控制項，請知道某些瀏覽器需要設定調整才能執行 ActiveX 控制項。 請參閱瀏覽器的檔，以瞭解如何啟用 ActiveX 控制項。

注意

完成本教學課程時，如果您收到無法建立 DLL 檔案的錯誤訊息，請關閉 PolyCtl.htm 檔案和 ActiveX 控制項測試容器，然後再次建置解決方案。 如果您仍然無法建立 DLL，請重新開機電腦，或使用終端機服務登出。

接下來，您會將自訂屬性新增至 控制項。

回到步驟 1 | 到步驟 3

另請參閱

教學課程