MFC-ActiveX-Steuerelemente: Hinzufügen von vordefinierten Methoden
Eine vordefinierte Methode unterscheidet sich von einer benutzerdefinierten Methode darin, dass sie bereits von der Klasse COleControl implementiert wurde. Beispielsweise enthält COleControl eine vordefinierte Memberfunktion, die die Refresh-Methode für Ihr Steuerelement unterstützt. Der Dispatchzuordnungseintrag dieser vordefinierten Methode ist DISP_STOCKFUNC_REFRESH.
Wichtig
ActiveX ist eine Legacytechnologie, die nicht für neue Software verwendet werden sollte. Weitere Informationen zu modernen Technologien, die ActiveX ablösen, finden Sie unter ActiveX-Steuerelemente.
COleControl unterstützt zwei vordefinierte Methoden: DoClick und Refresh. Refresh wird vom Benutzer des Steuerelements aufgerufen, um das Aussehen des Steuerelements sofort zu aktualisieren. DoClick wird aufgerufen, um das Click-Ereignis des Steuerelements auszulösen.
| Methode | Dispatchzuordnungseintrag | Kommentar |
|---|---|---|
DoClick |
DISP_STOCKPROP_DOCLICK( ) | Löst ein Click-Ereignis aus. |
Refresh |
DISP_STOCKPROP_REFRESH( ) | Aktualisiert sofort das Aussehen des Steuerelements. |
Hinzufügen einer Stock-Methode mithilfe des Assistenten zum Hinzufügen von Methoden
Mit dem Assistenten zum Hinzufügen von Methoden können Sie vordefinierte Methoden einfach hinzufügen. Das folgendem Verfahren demonstriert, wie Sie die Refresh-Methode zu einem Steuerelement hinzufügen, das mit dem MFC-ActiveX-Steuerelement-Assistenten erstellt wurde.
So fügen Sie die vordefinierte Refresh-Methode mithilfe des Assistenten zum Hinzufügen von Methoden hinzu:
Laden Sie das Steuerelementprojekt.
Erweitern Sie in der Klassenansicht den Bibliotheksknoten des Steuerelements.
Klicken Sie mit der rechten Maustaste auf den Schnittstellenknoten des Steuerelements (den zweiten Knoten des Bibliotheksknotens), um das Kontextmenü zu öffnen.
Klicken Sie im Kontextmenü auf die Option Hinzufügen, und klicken Sie danach auf Methode hinzufügen.
Dadurch wird der Assistent zum Hinzufügen von Methoden geöffnet.
Klicken Sie im Feld Methodenname auf Refresh.
Klicken Sie auf Fertig stellen.
Änderungen für vordefinierte Methoden beim Assistenten zum Hinzufügen von Methoden
Da die vordefinierte Refresh-Methode von der Basisklasse des Steuerelements unterstützt wird, ändert der Assistent zum Hinzufügen von Methoden die Klassendeklaration des Steuerelements in keiner Weise. Sie fügt der Dispatchzuordnung des Steuerelements und der zugehörigen IDL-Datei einen Eintrag für die Methode hinzu. Die folgende Zeile wird der Dispatchzuordnung des Steuerelements hinzugefügt, die sich in seiner Implementierungsdatei (.ccp) befindet.
DISP_STOCKFUNC_REFRESH()
Dadurch wird die Refresh-Methode für die Benutzer des Steuerelements verfügbar.
Die folgende Zeile wird der IDL-Datei des Steuerelements hinzugefügt:
[id(DISPID_REFRESH), helpstring("method Refresh")] void Refresh(void);
Diese Zeile weist der Refresh-Methode eine bestimmte ID-Nummer zu.