Přidání metody IDL MFC

Průvodce přidáním metody IDL MFC přidá metodu do rozhraní IDL (Interface Definition Library) definovaného v projektu Microsoft Framework Class (MFC). Pokud projekt obsahuje třídu přidruženou k rozhraní, průvodce také přidá metodu do třídy.

Chcete-li použít tohoto průvodce, musíte být v projektu MFC, projektu ActiveX nebo projektu ATL, který podporuje mfc. Pokud máte například projekt ovládacího prvku Microsoft ActiveX, můžete pomocí následujícího postupu přidat metodu do rozhraní IDL v řešení.

Tento průvodce se liší od Průvodce přidáním metody (který přidává metodu do rozhraní IDL) následujícími způsoby:

• Je specifický pro projekty MFC, ActiveX nebo ATL, které podporují MFC. Pro projekty ATL, které nepodporují MFC, je k dispozici pouze průvodce přidáním metody .

• Přidá následující položky, pokud se v projektu najde mapa Dispatch:

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

• Vygeneruje následující přidruženou implementaci metody:

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

Přidání metody do rozhraní

1. V nabídce Zobrazení vyberte Zobrazení třídy.

2. V zobrazení třídy rozbalte uzel projektu, aby se zobrazilo rozhraní, do kterého chcete přidat metodu.

3. Klikněte pravým tlačítkem myši na název rozhraní.

4. V místní nabídce vyberte Přidat a pak vyberte Přidat metodu.

5. V Průvodci přidáním metody IDL MFC zadejte informace o metodě.

6. Vyberte OK a přidejte metodu.

Seznam prvků uživatelského rozhraní

Následující část popisuje uživatelské rozhraní Průvodce metodou IDL MFC:

• Název metody

  Nastavte název metody. Následující tabulka popisuje možnosti názvu metody v závislosti na druhu rozhraní:

  Druh rozhraní	Název metody
  Duální rozhraní ATL, vlastní rozhraní a místní vlastní rozhraní	Zadejte vlastní název metody.
  MFC dispinterface	Zadejte vlastní název metody nebo ze seznamu vyberte navrhovaný název metody. Pokud ze seznamu vyberete název, zobrazí se odpovídající návratový typ v návratovém typu a nelze ho změnit.
  Mfc – ovládací prvek ActiveX – dispinterface	Zadejte vlastní název metody nebo vyberte jednu z burzovních metod: DoClick nebo Refresh. Další informace o burzovních metodách naleznete v tématu MFC – ovládací prvky ActiveX: Přidání skladových metod.

• Interní název

  K dispozici pouze v případech, kdy je typ metody vlastní. Interní název je název, který se použije v mapě odeslání, v souboru hlavičky (.h) a v souboru implementace (.cpp). Ve výchozím nastavení je tento název stejný jako název metody. Přidá se do rozhraní MFC dispinterface.

  Pokud přidáváte metodu do ovládacích prvků MFC nebo MFC ActiveX dispinterface, můžete změnit název metody, jak je popsáno v následující tabulce:

  Typ rozhraní	Interní název
  Duální rozhraní ATL, vlastní rozhraní a místní vlastní rozhraní	Není k dispozici.
  MFC dispinterface	Ve výchozím nastavení nastavte název metody. Můžete upravit interní název.
  Mfc – ovládací prvek ActiveX – dispinterface	Interní název můžete nastavit pouze pro vlastní metody. Metody akcií nepoužívají interní název.

• Návratový typ

  Datový typ vrácený metodou. Standardní návratový typ pro metody rozhraní je HRESULT.

  Pokud je rozhraní duální nebo vlastní rozhraní, je povolený pouze návratový HRESULT typ.

  Datový typ můžete nastavit podle typu rozhraní, do kterého se metoda přidává, jak je popsáno v následující tabulce:

  Druh rozhraní	Návratový typ
  Duální rozhraní	HRESULT. Nezměnitelný.
  Vlastní rozhraní	HRESULT. Nezměnitelný.
  Místní vlastní rozhraní	Zadejte vlastní návratový typ nebo ho vyberte ze seznamu.
  Dispinterface	Zadejte vlastní návratový typ nebo ho vyberte ze seznamu.
  Mfc – ovládací prvek ActiveX – dispinterface	Pokud implementujete akciovou metodu, návratový typ je nastaven na odpovídající hodnotu a je neměnný. Pokud vyberete metodu ze seznamu názvů metod a v části Vybrat typ metody vyberete vlastní typ, vyberte ze seznamu návratový typ.

• Typ metody

  K dispozici pouze pro ovládací prvky ActiveX mfc. Není k dispozici, pokud jste zadali název metody v názvu metody místo výběru metody ze seznamu.

  Pokud vyberete jednu z metod v seznamu název metody, v rozevíracím seznamu Typ metody vyberte buď Stock , nebo Vlastní implementace. Výběr metody má vliv na návratový typ a implementaci metody, kterou průvodce poskytuje, jak je popsáno v následující tabulce:

  Typ metody	Popis
  Akcie	Výchozí nastavení Vloží výchozí implementaci metody vybrané v seznamu názvů metody. Návratový typ je neměnný, pokud vyberete Sklad.
  Vlastní	Zadáte vlastní implementaci pro metodu vybranou v názvu metody. Můžete zadat vlastní návratový typ nebo ho vybrat ze seznamu návratového typu .

• Parametry

  Zobrazí parametry, modifikátory a typy metody. Průvodce aktualizuje seznam Parametry při přidávání parametrů.

• +

  Přidejte parametr. Do pole Parametry zadejte typ parametru, název a všechny modifikátory. Například int xa zvolte OK.

  Pokud nezadáte název parametru, průvodce ignoruje všechny výběry typu parametru a u projektů ATL se atributy parametrů také ignorují.

• x

  Odebere vybraný parametr ze seznamu Parametry .

• Ikona tužky

  Umožňuje upravit vybraný parametr.

• id

  Nastaví číselné ID, které identifikuje metodu. Další informace najdete id v referenční dokumentaci MIDL.

• call_as

  Určuje název vzdálené metody, která se má mapovat na tuto místní metodu. Další informace najdete call_as v referenční dokumentaci MIDL.

• helpcontext

  Určuje ID kontextu, které umožňuje uživateli zobrazit informace o této metodě v souboru nápovědy. Další informace najdete helpcontext v referenční dokumentaci MIDL.

• helpstring

  Určuje text, který popisuje přidružený prvek. Ve výchozím nastavení má název metody. Další informace naleznete v nápovědě v části MIDL reference.

Viz také

Průvodce přidáním metody
Přidání průvodce metodou IDL
Průvodci a dialogová okna MFC