新增IDL MFC方法

[新增 IDL MFC 方法精靈] 會將方法新增至您在 Microsoft Framework 類別 （MFC） 專案中定義的介面定義連結庫 （IDL） 介面。 如果專案包含與 介面相關聯的類別，精靈也會將 方法新增至 類別。

若要使用此精靈，您必須位於 MFC 專案、ActiveX 專案或支援 MFC 的 ATL 專案中。 例如，如果您有Microsoft ActiveX 控件專案，您可以使用下列程式將方法新增至方案中的 IDL 介面。

此精靈與 [新增方法精 靈] 不同（此方法會以下列方式將方法新增至 IDL 介面：

• 它專屬於支援 MFC 的 MFC、ActiveX 或 ATL 專案。 對於不支援 MFC 的 ATL 專案，只有 [新增方法精 靈] 可用。

• 如果在專案中找到分派對應，則會新增下列專案：

  BEGIN_DISPATCH_MAP(CMFCApplication2Doc, CDocument)
      DISP_FUNCTION_ID(CMFCApplication2Doc, "methodName", dispidmethodName, internalName, VT_EMPTY, VTS_NONE)
  END_DISPATCH_MAP()
  

• 它會產生下列相關聯的方法實作：

  void CMFCApplication2Doc::internalName()
  {
       AFX_MANAGE_STATE(AfxGetAppModuleState());
       // TODO: Add your dispatch handler code here
  }
  

將方法新增至介面

1. 在 [ 檢視] 功能表上，選取 [類別檢視]。

2. 在 [類別檢視] 中，展開專案節點，以顯示您要新增方法的介面。

3. 以滑鼠右鍵按一下介面的名稱。

4. 在快捷方式功能表上，選取 [新增 ]，然後選取 [ 新增方法]。

5. 在 [ 新增 IDL MFC 方法 精靈] 中，提供 方法的相關信息。

6. 選取 [ 確定 ] 以新增 方法。

UI 元素清單

下一節說明新增 IDL MFC 方法精靈 UI：

• 方法名稱

  設定方法的名稱。 下表說明方法名稱選項，視介面類型而定：

  介面種類	方法名稱
  ATL 雙重介面、自訂介面和本機自訂介面	提供您自己的方法名稱。
  MFC 分配介面	提供您自己的方法名稱，或從清單中選取建議的方法名稱。 如果您從清單中選取名稱，適當的傳回類型會出現在 [傳回類型] 中，而且無法變更。
  MFC ActiveX 控制項分配介面	提供您自己的方法名稱，或選取其中一個股票方法： DoClick 或 Refresh。 如需股票方法的詳細資訊，請參閱 MFC ActiveX 控件：新增庫存方法。

• 內部名稱

  只有在方法類型為自定義時才能使用。 內部名稱 是分派對應、標頭 （.h） 檔案和實作 （.cpp） 檔案中使用的名稱。 根據預設，此名稱與 [方法名稱] 相同。 它已新增至 MFC dispinterface。

  如果您要將 方法新增至 MFC 或 MFC ActiveX 控件 dispinterface，您可以變更方法名稱，如下表所述：

  介面類型	內部名稱
  ATL 雙重介面、自訂介面和本機自訂介面	無法使用。
  MFC 分配介面	預設設定為方法名稱。 您可以編輯內部名稱。
  MFC ActiveX 控制項分配介面	您只能為自訂方法設定內部名稱。 內建方法不會使用內部名稱。

• 傳回類型

  方法傳回的資料類型。 介面方法的標準傳回類型為 HRESULT。

  如果介面是雙重介面或自定義介面，則只 HRESULT 允許傳回型別。

  您可以根據要加入方法的介面類型來設定資料類型，如下表所述：

  介面種類	傳回類型
  雙重介面	HRESULT. 無法變更。
  自訂介面	HRESULT. 無法變更。
  本機自訂介面	提供您自己的傳回類型，或從清單中選取一個。
  分配介面 (Dispinterface)	提供您自己的傳回類型，或從清單中選取一個。
  MFC ActiveX 控制項分配介面	如果您實作內建方法，傳回型別則會設定為適當的值，而且無法變更。 如果您從 [方法名稱] 清單中選取方法，然後在 [選取方法類型] 下選取 [自定義]，請從清單中選取傳回類型。

• 方法類型

  僅適用於 MFC ActiveX 控制項。 如果您在 [方法名稱] 中 提供方法名稱 ，而不是從清單中選取方法，則無法使用。

  如果您在 [方法名稱] 列表中選取其中一個方法，請在 [方法類型] 下拉式清單中選取 [Stock] 或 [自定義實作]。 方法的選取會影響精靈所提供的傳回類型和方法實作，如下表所述：

  方法類型	描述
  內建	預設值。 在 [方法名稱] 清單中插入選取之方法的預設實作。 如果您選取 [內建] 則無法變更 [傳回型別]。
  自訂	您可以針對在 [方法名稱] 中選取的方法提供自定義實作。 您可以提供您自己的傳回類型，或從 [傳回類型 ] 列表中選取一個。

• 參數

  顯示方法的參數、修飾詞和類型。 當您新增參數時，精靈會 更新 [參數 ] 清單。

• +

  新增 參數。 在 [ 參數] 中，輸入參數類型、名稱和任何修飾詞。 例如， int x選擇 [ 確定]。

  如果您未提供參數名稱，精靈會忽略任何 參數類型 選取專案;而且針對 ATL 專案，也會忽略參數屬性。

• x

  從 [參數 ] 列表中移除選取的參數。

• [鉛筆] 圖示

  編輯選取的參數。

• id

  設定識別方法的數值標識碼。 如需詳細資訊，請參閱 id MIDL 參考。

• call_as

  指定要對應至這個本機方法之遠端方法的名稱。 如需詳細資訊，請參閱 call_as MIDL 參考。

• helpcontext

  指定內容識別碼，讓使用者可在說明檔中檢視此方法的相關資訊。 如需詳細資訊，請參閱 helpcontext MIDL 參考。

• helpstring

  指定描述相關聯項目的文字。 根據預設，其 方法名稱。 如需詳細資訊，請參閱 MIDL 參考中的 helpstring。

另請參閱

新增方法精靈
新增IDL方法精靈
MFC 精靈和對話框