將連接點加入物件

ATL 教學課程示範如何建立支持連接點的控件、如何新增事件，以及如何實作連接點。 ATL 會使用 IConnectionPointImpl 類別實作連接點。

若要實作連接點，您有兩個選項：

• 將連接點新增至控件或物件，以實作您自己的傳出事件來源。

• 重複使用在另一個類型連結庫中定義的連接點介面。

不論是哪一種情況，「實作連接點精靈」都會使用類型連結庫來執行其工作。

將連接點加入至控件或物件

1. 在 .idl 檔案的連結庫區塊中定義 dispinterface。 如果您在使用 ATL 控件精靈建立控件時啟用連接點的支援，則會建立 dispinterface。 如果您在建立控件時未啟用連接點的支援，則必須手動將 dispinterface 新增至 .idl 檔案。 以下是 dispinterface 的範例。 傳出介面不需要分派介面，但許多腳本語言，例如 VBScript 和 JScript 都需要這樣做，因此此範例會使用兩個 dispinterface：

   [
      uuid(3233E37D-BCC0-4871-B277-48AE6B61224A),
      helpstring("Buddy Events")
   ]
   dispinterface DBuddyEvents
   {
      properties:
      methods:
   };
   

   使用 uuidgen.exe 或 guidgen.exe 公用程式來產生 GUID。

2. 在專案的 .idl 檔案中，將 dispinterface 新增為 [default,source] coclass 中的 物件介面。 同樣地，如果您在建立控件時啟用連接點的支援，ATL 控件精靈將會建立 [default,source] 專案。 若要手動新增這個專案，請以粗體新增這一行：

   coclass Buddy
   {
      [default] interface IBuddy;
      [default,source] dispinterface DBuddyEvents;
   };
   

   如需範例，請參閱 Circ ATL 範例中的 .idl 檔案。

3. 使用 [類別檢視] 將方法和屬性新增至事件介面。 以滑鼠右鍵按兩下 [類別檢視] 中的類別，指向 快捷方式功能表上的 [新增 ]，然後按兩下[ 新增連接點]。

4. 在 [實作連接點精靈] 的 [ 來源介面 ] 列表框中，選取 [專案介面]。 如果您選擇控制件的介面，然後按 [確定]，您將：

   • 使用事件 Proxy 類別產生頭檔，該類別會實作將呼叫事件的傳出程序代碼。

   • 將專案新增至連接點對應。

   您也會看到電腦上所有類型連結庫的清單。 如果您想要實作在另一個類型連結庫中找到完全相同的傳出介面，您應該只使用這些其他類型連結庫的其中一個來定義連接點。

重複使用在另一個類型連結庫中定義的連接點介面

1. 在 [類別檢視] 中，以滑鼠右鍵單擊實作 BEGIN_COM_MAP 巨集的類別，指向 快捷方式功能表上的 [新增 ]，然後按兩下 [ 新增連接點]。

2. 在 [實作連接點精靈] 中，選取類型庫和類型庫中的介面，然後按兩下 [ 新增]。

3. 將 .idl 檔案編輯為下列其中一項：

   • 從使用事件來源之物件的 .idl 檔案複製 dispinterface。

   • 在該 類型連結庫上使用 importlib 指令。

另請參閱

連接點