Freigeben über

CommandTargetExec-Ereignis

  • Artikel

Tritt auf, wenn der Host eines aktiven Dokuments (Active Document) ein aktives Dokument über den auszuführenden Befehl benachrichtigt.

PROCEDURE Object.CommandTargetExec
LPARAMETERS nCommandID, nExecOption, eArgIn, eArgOut

Parameter

  • nCommandID
    Ein Parameter, der vom Host eines aktiven Dokuments an das CommandTargetExec-Ereignis übergeben wurde und den auszuführenden Befehl kennzeichnet. Die folgende Tabelle zeigt eine Liste der an das Ereignis übergebenen Werte, die Visual FoxPro verarbeiten kann, sowie den zugehörigen auszuführenden Befehl.

    nCommandID FOXPRO.H-Konstante -Befehl
    1 CMDID_OPEN Befehl Öffnen im Menü Datei.
    2 CMDID_NEW Befehl Neu im Menü Datei.
    3 CMDID_SAVE Befehl Speichern im Menü Datei.
    4 CMDID_SAVEAS Befehl Speichern unter im Menü Datei.
    5 CMDID_SAVECOPYAS Befehl Kopie speichern unter im Menü Datei.
    6 CMDID_PRINT Befehl Drucken im Menü Datei.
    7 CMDID_PRINTPREVIEW Befehl Seitenansicht im Menü Datei.
    8 CMDID_PAGESETUP Befehl Seite einrichten im Menü Datei.
    9 CMDID_SPELL Befehl Rechtschreibung im Menü Extras.
    10 CMDID_PROPERTIES Befehl Eigenschaften im Menü Datei.
    11 CMDID_CUT Befehl Ausschneiden im Menü Bearbeiten.
    12 CMDID_COPY Befehl Kopieren im Menü Bearbeiten.
    13 CMDID_PASTE Befehl Einfügen im Menü Bearbeiten.
    14 CMDID_PASTESPECIAL Befehl Inhalte einfügen im Menü Bearbeiten.
    15 CMDID_UNDO Befehl Rückgängig im Menü Bearbeiten.
    16 CMDID_REDO Befehl Wiederherstellen im Menü Bearbeiten.
    17 CMDID_SELECTALL Befehl Alles markieren im Menü Bearbeiten.
    18 CMDID_CLEARSELECTION Befehl Löschen im Menü Bearbeiten.
    19 CMDID_ZOOM Befehl Zoom im Menü Ansicht.
    20 CMDID_GETZOOMRANGE Ermittelt den für den Befehl Zoom im Menü Ansicht verfügbaren Zoombereich.
    21 CMDID_UPDATECOMMANDS Informiert das aktive Dokument über Statusänderungen.
    22 CMDID_REFRESH Fordert das aktive Dokument auf, die Anzeige zu aktualisieren. Vom aktiven Dokument implementiert.
    23 CMDID_STOP Fordert das aktive Dokument auf, die Verarbeitung einzustellen.
    24 CMDID_HIDETOOLBARS Fordert das aktive Dokument auf, die Symbolleisten auszublenden. Vom aktiven Dokument implementiert.
    25 CMDID_SETPROGRESSMAX Bestimmt den Maximalwert der Fortschrittsanzeige.
    26 CMDID_SETPROGRESSPOS Bestimmt den aktuellen Wert der Fortschrittsanzeige.
    27 CMDID_PROGRESSTEXT Bestimmt den Text der Fortschrittsanzeige.
    28 CMDID_SETTITLE Bestimmt den Text der Titelleiste.
    29 CMDID_DOWNLOADSTATE Wird vom Host gesendet, wenn dessen Downloadstatus sich ändert.
    30 CMDID_STOPDOWNLOAD Hält das Herunterladen an, wenn ausgeführt.
    31 CMDID_ONTOOLBARACTIVATED Eine der Symbolleisten des Containers hat den Fokus erhalten.
    36 CMDID_ENABLE_INTERACTION Vom Host des aktiven Dokuments gesendet, um das aktive Dokument zum Anhalten oder zur Wiederaufnahme von Multimedia (Audio oder Animation) im aktiven Dokument zu veranlassen.

    Legt den Wert Wahr (1) für eArgIn fest, wenn eine Multimedia-Datei wiederaufgenommen werden soll, die in einem Steuerelement im aktiven Dokument ausgeführt wird, bzw. Falsch (0), wenn die Multimedia-Datei angehalten werden soll.

    Internet Explorer 4.0 verwendet diesen Befehl, um ein aktives Dokument darüber zu informieren, dass es minimiert oder vollständig durch ein anderes Fenster bedeckt ist, damit das aktive Dokument die Wiedergabe von Multimedia-Informationen unterbrechen kann.
    37 CMDID_ONUNLOAD Vom Host des aktiven Dokuments gesendet, bevor die Navigation zu einem anderen Ort initiiert oder der Host geschlossen wird. Setzen Sie eArgOut auf Falsch (.F.), um zu verhindern, dass ein aktives Dokument von seinem Host geschlossen wird. Soll ein aktives Dokument von seinem Host geschlossen werden können, setzen Sie eArgOut auf Wahr (.T.).

  • nExecOption
    Ein an das CommandTargetExec-Ereignis übergebener Parameter, der die Standardaktion bezeichnet, die für den angegebenen Befehl gewünscht ist.

    Die folgende Tabelle zeigt eine Liste der Werte für nExecOption und die durchgeführten Aktionen (Maßnahmen).

    nExecOption FOXPRO.H-Konstante Maßnahme
    0 CMDEXECOPT_DODEFAULT Verwenden des Standardverhaltens, egal, ob Benutzer eine Eingabeaufforderung erhalten oder nicht.
    1 CMDEXECOPT_PROMPTUSER Ausführen des Befehls nach Erhalt der Benutzereingabe.
    2 CMDEXECOPT_DONTPROMPTUSER Ausführen des Befehls ohne eine Eingabeaufforderung an Benutzer. So führt das Klicken auf die Schaltfläche Drucken in der Symbolleiste beispielsweise unmittelbar zum Drucken des Dokuments, ohne dass Benutzer eine Eingabeaufforderung erhalten
    3 CMDEXECOPT_SHOWHELP Anzeigen der Hilfe für den zugehörigen Befehl, jedoch ohne diesen tatsächlich auszuführen.

  • eArgIn
    Ein vom Host des aktiven Dokuments an das CommandTargetExec-Ereignis übergebener Parameter. Dieser Parameter ist üblicherweise der NUL-Wert, ausgenommen den Fall, dass nCommandID den Wert 36 hat. Wenn nCommandID den Wert 36 hat, enthält eArgIn einen Wert. Weitere Informationen über die logischen an eArgIn übergebenen Parameter finden sie in der Tabelle zur Beschreibung der nCommandID-Parameter weiter oben.

  • eArgOut
    Ein vom CommandTargetExec-Ereignis an den Host des aktiven Dokuments zurückgegebener Ausgabeparameter. Dieser Parameter ist üblicherweise der NULL-Wert, ausgenommen den Fall, dass nCommandID den Wert 37 hat. Wenn nCommandID den Wert 37 hat (anzeigend, dass der Host des aktiven Dokuments schließen oder zu einem anderen Ort navigieren wird), können Sie eArgOut auf Falsch (.F.) setzen, um zu verhindern, dass das aktive Dokument von seinem Host geschlossen wird. Soll ein aktives Dokument von seinem Host geschlossen werden können, setzen Sie eArgOut auf Wahr (.T.).

Hinweise

Das CommandTargetExec-Ereignis ermöglicht einem aktiven Dokument (Active Document) die Durchführung von benutzerdefinierten Aktionen, die auf Befehlen basieren, die vom Host an sein aktives Dokument gesendet werden. Diese Befehle können daraufhin gesendet werden, dass Benutzer ein Menü oder ein Element der Symbolleiste ausgewählt haben, oder daraufhin, dass ein Ereignis im Host des aktiven Dokuments ausgelöst worden ist. Der vom CommandTargetExec-Ereignis zurückgegebene Wert benachrichtigt den Host des aktiven Dokuments darüber, ob Sie den Befehl verarbeitet haben. Ist dies nicht der Fall, kann der Host des aktiven Dokuments seine eigene Standardverarbeitung für den Befehl durchführen.

Die folgende Tabelle zeigt eine Liste der entsprechenden Werte, die vom CommandTargetExec-Ereignis zurückzugeben sind.

Rückgabewert FOXPRO.H-Konstante Befehlsaktion
0 CMD_OK Befehl erfolgreich vom aktiven Dokument verarbeitet.

Geben Sie diesen Wert zurück, wenn das aktive Dokument den durch nCommandID bezeichneten Befehl verarbeitet hat. Wurde beispielsweise der Befehl Öffnen im Menü Datei auf dem Host ausgewählt, kann Ihr aktives Dokument in seinem CommandTargetExec-Ereignis festlegen, dass nCommandID gleich 1 ist und dann die eigene Routine zum Öffnen von Dateien ausführen, eventuell unter Verwendung der Visual FoxPro GETFILE( )-Funktion.
1 CMD_NOTSUPPORTED Befehl vom aktiven Dokument nicht unterstützt.

Geben Sie diesen Wert zurück, wenn der durch nCommandID bezeichnete Befehl nicht als Befehl erkannt wird, der vom aktiven Dokument bearbeitet werden kann.
2 CMD_DISABLED Befehl ist für das aktive Dokument deaktiviert.

Geben Sie diesen Wert zurück, wenn der durch nCommandID bezeichnete Befehl zur Zeit deaktiviert ist und vom aktiven Dokument nicht ausgeführt werden kann.
3 CMD_NOHELP Beim aktiven Dokument ist keine Hilfe für den Befehl verfügbar.

Geben Sie diesen Wert zurück, wenn das aktive Dokument für den durch nCommandID bezeichneten Befehl keine Hilfe unterstützt.
4 CMD_CANCELED Der Benutzer hat die Ausführung des Befehls abgebrochen.

Geben Sie diesen Wert zurück, wenn das aktive Dokument den durch nCommandID bezeichneten Befehl zu verarbeiten versucht hat, aber Benutzer die Operation abgebrochen haben.

Wenn das CommandTargetExec-Ereignis keinen benutzerdefinierten Code enthält, wird 2 (Befehl vom aktiven Dokument nicht unterstützt) an den Host des aktiven Dokuments zurückgegeben. Wenn das CommandTargetExec-Ereignis benutzerdefinierten Code enthält, aber keine RETURN-Anweisung beinhaltet, wird 0 (Befehl erfolgreich vom aktiven Dokument bearbeitet) zum Host des aktiven Dokuments zurückgegeben.

Visual FoxPro verwendet für die CommandTargetExec- und CommandTargetQuery-Ereignisse die IOleCommandTarget-Schnittstelle. Weitere Informationen hierzu, wie diese Ereignisse implementiert sind, finden Sie in der MSDN-Bibliothek unter "IOleCommandTarget".

Sie können die Anzeige des Dialogfeldes Info mit Hilfe von CMDID_PROPERTIES im nCommand-Parameter steuern.

So zeigen Sie das Dialogfeld an

Geben Sie CMD_NOTSUPPORTED (1) aus dem CommandTargetExec-Ereignis zurück.

So unterdrücken Sie das Dialogfeld

Geben Sie CMD_OK (0) aus dem CommandTargetExec-Ereignis zurück. Enthält das CommandTargetExec-Ereignis keinen Code, zeigt die Visual FoxPro standardmäßig das Dialogfeld Info an.

Siehe auch

CommandTargetQuery-Ereignis | GETFILE( )-Funktion

Betrifft: ActiveDoc-Objekt