新增 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 精靈和對話方塊