Aktionen in die Aktionsliste einfügen
Nach oben zu Die Hauptobjekte der IDE verwenden
Sie können mit dem nativen Tools-API-Interface INTAServices
die Aktionsliste der IDE um eigene Aktionen erweitern.
Einfügen von Aktionen in die Aktionsliste
So fügen Sie der Aktionsliste der IDE eine Instanz von TAction hinzu:
- Erstellen Sie eine Instanz von
TAction
mit dem Aktionslisten-Objekt als übergeordnetes Element. Das Aktionslisten-Objekt ist die EigenschaftActionList
der VariableBorlandIDEServices
, die in den TypINTAServices
umgewandelt wird. - Konfigurieren Sie Ihre Aktion. Zum Beispiel:
- Legen Sie einige Eigenschaften, wie Name, Caption, Hint oder ShortCut, fest.
- Weisen Sie dem Ereignis OnExecute eine Behandlungsroutine zu. Die IDE führt die angegebene Ereignisbehandlungsroutine aus, wenn ein Benutzer Ihre Aktion ausführt.
- Weisen Sie dem Ereignis OnUpdate eine Behandlungsroutine zu, beispielsweise um eine spezielle Behandlung bei aktivierter bzw. deaktivierter Aktion vorzusehen.
- Um ein Symbol für Ihre Aktion festzulegen, fügen Sie Ihr Symbol der Bilderliste der IDE hinzu, und weisen Sie dessen Index der Eigenschaft ImageIndex Ihrer Aktion zu.
- Konfigurieren Sie Ihre Aktion so, dass Benutzer sie einer Symbolleiste hinzufügen können.
- Rufen Sie
AddActionMenu
für die VariableBorlandIDEServices
auf, deren Typ inINTAServices
umgewandelt wurde, und stellen Sie die folgenden Parameter bereit:- Einen leeren String. Der ersten Parameter ist nur erforderlich, wenn Sie dem Hauptmenü einen Menüeintrag hinzufügen.
- Ihr Aktionsobjekt.
- Nil. Dieser Parameter ist auch nur erforderlich, um dem Hauptmenü einen Menüeintrag hinzuzufügen.
Delphi:
if Supports(BorlandIDEServices, INTAServices, NTAServices) then
begin
MyAction := TAction.Create(nil);
MyAction.Caption := 'My Action';
NTAServices.AddActionMenu('', MyAction, nil);
end;
C++:
_di_INTAServices NTAServices;
if (BorlandIDEServices->Supports(NTAServices)) {
MyAction = new TAction(NULL);
MyAction->Caption = "My Action";
NTAServices->AddActionMenu("", MyAction, NULL);
}
Zulassen, dass Benutzer Ihre Aktion einer Symbolleiste hinzufügen
Damit Benutzer Ihre Aktion einer Symbolleiste der IDE hinzufügen können, geben Sie in der Eigenschaft Category Ihrer Aktion einen Wert an. Zum Beispiel "Meine Aktionen". Der Benutzer kann dann Ihre Aktion einer beliebigen Symbolleiste als Schaltfläche hinzufügen.
Wenn Sie zulassen, dass Benutzer Ihre Aktion einer Symbolleiste hinzufügen, müssen Sie in Ihrem Finalisierungscode alle Symbolleisten-Schaltflächen suchen, die auf Ihre Aktion verweisen, und diese Schaltflächen entfernen.