Hinzufügen einer IDL-Methode

Der Assistent zum Hinzufügen von IDL-Methoden fügt eine Methode zu einer IDL-Schnittstelle (Interface Definition Library) hinzu, z. B. in einem ATL-Projekt, das eine IDL-Datei enthält. Dieser Assistent ist in Projekten, die MFC unterstützen, nicht verfügbar.

Dieser Assistent unterscheidet sich vom Assistenten zum Hinzufügen von Methoden und dem Assistenten zum Hinzufügen von IDL MFC-Methoden auf folgende Weisen:

• Der Assistent zum Hinzufügen von Methoden fügt einer Schnittstelle in Ihrem Projekt eine Methode hinzu und kann die der Schnittstelle zugeordnete Klasse aktualisieren.
• Der Assistent zum Hinzufügen von IDL MFC-Methoden ist für MFC-, ActiveX- oder ATL-Projekte spezifisch, die MFC unterstützen.

Hinzufügen einer Methode zu Ihrer IDL-Schnittstelle

1. Wählen Sie im Menü Ansicht die Option Klassenansicht aus.

2. Erweitern Sie den Projektknoten in der Klassenansicht, um die IDL-Schnittstelle (.idl-Datei) anzuzeigen, der die Methode hinzugefügt werden soll.

3. Klicken Sie mit der rechten Maustaste auf den Namen der Schnittstelle.

4. Wählen Sie im Kontextmenü Hinzufügen>Methode hinzufügen aus.

5. Geben Sie im Assistenten zum Hinzufügen von IDL-Methoden die Informationen zum Erstellen der Methode an.

6. Wählen Sie OK aus, um die Methode hinzuzufügen.

Liste der Benutzeroberflächenelemente

Im folgenden Abschnitt wird die Assistentenoberfläche beschrieben, die Sie zum Hinzufügen einer Methode verwenden:

• Methodenname

  Geben Sie einen Namen für die Methode an.

• Rückgabetyp

  Der von der Methode zurückgegebene Datentyp. Fehlercodes aus Methoden, die in einer Schnittstelle definiert sind, werden standardmäßig mithilfe von HRESULT zurückgegeben.

  In der folgenden Tabelle werden die verschiedenen Arten von Schnittstellen beschrieben, zu denen Sie eine Methode hinzufügen können, sowie der zulässige Rückgabetyp. Bei dualen und benutzerdefinierten Schnittstellen muss der Rückgabetyp HRESULT sein, was Sie der Assistent nicht mehr ändern lässt.

  Schnittstellenart	Rückgabetyp
  Duale Schnittstelle	HRESULT. Kann nicht geändert werden.
  Benutzerdefinierte Schnittstelle	HRESULT. Kann nicht geändert werden.
  Lokale benutzerdefinierte Schnittstelle	Geben Sie Ihren eigenen Rückgabetyp an, oder wählen Sie einen aus der Dropdownliste aus.
  Disp-Schnittstelle	Geben Sie Ihren eigenen Rückgabetyp an, oder wählen Sie einen aus der Dropdownliste aus.

• Parameter

  Zeigt die Parameter, Modifizierer und Typen der Methode an.

• +

  Fügen Sie einen Parameter hinzu. Geben Sie in Parameter den Typ, den Namen und alle Modifizierer des Parameters ein. Beispielsweise [in] int i, und wählen Sie OK aus.

• x

  Entfernt den ausgewählten Parameter aus der Liste Parameter.

• in/out-Parameterwerte von Typen ableiten

  Fügt das Attribut [in] oder [out] ein, basierend auf dem Typ des Parameters.

• Letzten Parameter als Rückgabewert festlegen (retval)

  Der letzte Parameter wird als Rückgabewert der Methode behandelt.

• Attribute

  Die folgenden Attribute werden auch in der MIDL-Referenz beschrieben.

  • id

    Legt die numerische ID fest, die die Methode identifiziert. Weitere Informationen finden Sie unter id.

  • call_as

    Gibt den Namen der Remotemethode an, die dieser lokalen Methode zugeordnet werden soll. Weitere Informationen finden Sie unter call_as.

  • helpcontext

    Gibt eine Kontext-ID an, die das Anzeigen von Informationen über diese Methode in der Hilfedatei ermöglicht. Weitere Informationen finden Sie unter helpcontext.

  • helpstring

    Gibt die Zeichenfolge an, die zum Beschreiben des Elements verwendet werden soll, für die sie gilt. Weitere Informationen finden Sie unter helpstring.

• Zusätzliche Attribute

  • hidden

    Gibt an, dass die Methode vorhanden ist, aber nicht in einem benutzerorientierten Browser angezeigt werden sollte. Weitere Informationen finden Sie unter hidden.

  • local

    Gibt an, dass eine Schnittstelle oder Funktion nicht remote ist. Weitere Informationen finden Sie unter local.

  • restricted

    Gibt an, dass eine Bibliothek oder ein Member eines Moduls, einer Schnittstelle oder einer dispinterface nicht willkürlich aufgerufen werden kann. Weitere Informationen finden Sie unter restricted.

  • source

    Gibt an, dass ein Member einer coclass-Eigenschaft oder -Methode eine Ereignisquelle ist. Für einen Member einer coclass bedeutet dieses Attribut, dass der Member nicht implementiert, sondern aufgerufen wird. Weitere Informationen finden Sie unter source.

Siehe auch

Assistent zum Hinzufügen von Methoden
Assistent zum Hinzufügen von IDL MFC-Methoden