Share via


MFC-ActiveX-Steuerelemente: Hinzufügen von vordefinierten Methoden

Eine vordefinierte Methode unterscheidet sich von einer benutzerdefinierten Methode, da sie bereits in die COleControl- Klasse implementiert wird. Beispielsweise enthält vordefinierte COleControl eine Memberfunktion, die die Aktualisierungsmethode für das Steuerelement unterstützt. Der vordefinierte Dispatchzuordnungseintrag für diese Methode lautet DISP_STOCKFUNC_REFRESH.

COleControl unterstützt zwei vordefinierten Methoden: DoClick und Aktualisierung. Aktualisierung wird vom Benutzer des Steuerelements aufgerufen, um die Darstellung des Steuerelements auf einmal aktualisieren; DoClick wird aufgerufen, um das Click-Ereignis des Steuerelements ausgelöst.

Methode

Dispatchzuordnungseintrag

Kommentar

DoClick

DISP_STOCKPROP_DOCLICK()

Löst ein Click-Ereignis aus.

Aktualisieren

DISP_STOCKPROP_REFRESH()

Aktualisiert sofort die Darstellung des Steuerelements.

Hinzufügen einer vordefinierten Methode mithilfe des Assistenten zum Hinzufügen von Methoden

Eine vordefinierte Methode hinzuzufügen ist mit Assistent zum Hinzufügen von Methoden einfach. Die folgende Prozedur veranschaulicht das Hinzufügen der Aktualisierungsmethode auf ein Steuerelement, das mit dem MFC-ActiveX-Steuerelement-Assistenten erstellt wird.

So der vordefinierten Aktualisierungsmethode mit dem Assistenten zum Hinzufügen von Methoden hinzufügen

  1. Laden Sie das Projekt des Steuerelements.

  2. Erweitern Sie in der Klassenansicht den Bibliotheksknoten des Steuerelements.

  3. Klicken Sie auf den Schnittstellenknoten für das Steuerelement (der zweite Knoten des Bibliotheksknotens) mit der rechten Maustaste um das Kontextmenü zu öffnen.

  4. Klicken Sie im Kontextmenü auf Hinzufügen und dann auf Methode hinzufügen.

    Dadurch wird der Assistent zum Hinzufügen von Methoden.

  5. Im Feld Methodenname klicken Sie auf Aktualisieren.

  6. Klicken Sie auf Fertig stellen.

Assistent zum Hinzufügen von Methodenen-Änderungen für vordefinierte Methoden

Da die vordefinierte Aktualisierungsmethode durch die Basisklasse des Steuerelements unterstützt wird, wird Assistent zum Hinzufügen von Methoden nicht die Klassendeklaration des Steuerelements in jeder Hinsicht. Sie fügt einen Eintrag für die Methode der Dispatchzuordnung des Steuerelements und seiner IDL-Datei hinzu. In der folgenden Zeile wird der Dispatchzuordnung des Steuerelements hinzugefügt, in der Implementierungsdatei (.CPP):

DISP_STOCKFUNC_REFRESH()

Dies macht die Aktualisierungsmethode verfügbar für die Benutzer des Steuerelements.

In der folgenden Zeile wird der IDL-Datei des Steuerelements hinzugefügt:

[id(DISPID_REFRESH), helpstring("method Refresh")] void Refresh(void);

Diese Zeile weist der Aktualisierungsmethode ein bestimmte ID-Nummer zu.

Siehe auch

Konzepte

MFC-ActiveX-Steuerelemente