CommandTargetQuery-Ereignis

Tritt auf, wenn der Host eines aktiven Dokuments (Active Document) seine Benutzerschnittstelle aktualisiert.

PROCEDURE Object.CommandTargetQuery
LPARAMETERS aCommands, nCommandTextFlag, cCommandTextOut

Parameter

• aCommands
  Ein zweidimensionales Array, das eine Liste von Befehlen enthält, die vom Host des aktiven Dokuments unterstützt werden.

  Die erste Spalte des Arrays enthält numerische Werte, die den Befehlen entsprechen, die vom Host des aktiven Dokuments unterstützt werden. Eine Liste der Befehle und ihrer numerischen Werte finden Sie beim nCommandID-Parameter unter CommandTargetExec-Ereignis.

  Die zweite Spalte des Arrays enthält numerische Werte, die dem Unterstützungsstatus für die jeweiligen Befehle entsprechen. Die folgende Tabelle zeigt eine Liste der Werte, die in der zweiten Spalte enthalten sein können, und den entsprechenden Unterstützungsstatus für die Befehle.

  Value	FOXPRO.H-Konstante	Beschreibung
  0	CMDF_NOTSUPPORTED	Der Befehl wird von diesem Objekt nicht unterstützt.
  1	CMDF_SUPPORTED	Der Befehl wird von diesem Objekt unterstützt.
  2	CMDF_ENABLED	Der Befehl ist verfügbar und aktiviert.
  4	CMDF_LATCHED	Der Befehl ist ein Ein-/Ausschalter und gegenwärtig an.
  8	CMDF_NINCHED	Der Befehl ist ein Ein-/Ausschalter, aber der Zustand lässt sich nicht bestimmen, da sich das Attribut dieses Befehls in der relevanten Auswahl sowohl im Ein- als auch im Auszustand befindet. Dieser Zustand entspricht z. B. dem Zwischenzustand eines Kontrollkästchens mit drei Zuständen.

  Die zweite Spalte des Arrays enthält anfänglich für alle Befehle Null (0), mit Ausnahme von CMDID_PROPERTIES. Ihr Ereigniscode sollte einen Wert in der zweiten Spalte speichern, um den Grad der Unterstützung anzugeben, die vom aktiven Dokument für den jeweiligen Befehl zur Verfügung gestellt wird. Sie können alle Kombinationen dieser Werte einfügen, um zusätzliche Unterstützungsebenen festzulegen. Wenn beispielsweise Ihre Prozedur des aktiven Dokuments für einen Befehl unterstützt wird (1) sowie verfügbar und aktiviert (2) ist, speichern Sie 3 (1 + 2) in der zweiten Spalte des entsprechenden Befehls.

  Sie können auch im Menü Datei den Befehl Eigenschaften deaktivieren, indem Sie den aCommands-Wert der 2. Spalte für CMDID_PROPERTIES auf 0 setzen. Der Standardwert für die 2. Spalte für CMDID_PROPERTIES ist 3, damit das Standarddialogfeld Info unterstützt wird. Weitere Informationen zur Verwendung von CMDID_PROPERTIES finden Sie unter CommandTargetExec-Ereignis.

• nCommandTextFlag
  Ein vom Host des aktiven Dokuments an das CommandTargetExec-Ereignis übergebener Parameter. nCommandTextFlag bezeichnet den Typ der Befehlsinformation, die mit Hilfe des cCommandTextOut-Parameters an den Host des aktiven Dokuments zu übergeben ist. Die folgende Tabelle zeigt die Werte für nCommandTextFlag und die entsprechenden Befehlsinformationen, die an den Host des aktiven Dokuments zu übergeben sind.

  nCommandTextFlag	Befehlsinformationen
  0	Es werden keine zusätzlichen Informationen angefordert.
  1	Das aktive Dokument sollte den lokalisierten Befehlsnamen bereitstellen.
  2	Das aktive Dokument sollte für den Befehl die Zeichenfolge für die lokalisierte Statusleiste bereitstellen.

• cCommandTextOut
  Ein Parameter, der vom CommandTargetExec-Ereignis an den Host des aktiven Dokuments übergeben wird. cCommandTextOut ist der Text, der für einen Befehl angezeigt wird, und zwar üblicherweise in der Statusleiste des Hosts des aktiven Dokuments. cCommandTextOut gilt für den Befehl in der ersten Zeile des Arrays.

Hinweise

Mit Hilfe des CommandTargetQuery-Ereignisses können Sie den Host des aktiven Dokuments (Active Document) darüber in Kenntnis setzen, welche Befehle das aktive Dokument unterstützt und welche Art von Unterstützung für den jeweiligen Befehl verfügbar ist. Sie können außerdem den Text angeben, der bei Wahl eines Befehls (meist eines Menüeintrags) angezeigt wird.

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

Beachten Sie, dass die Internet Explorer-Versionen 3 und 4 den Befehlstext üblicherweise nicht über cCommandTextOut anfordern. Daher ist nCommandTextFlag meist Null (0) und cCommandTextOut enthält den NULL-Wert. Diese Parameter wurden im Hinblick auf künftige Kompatibilität mit der IOleCommandTarget-Schnittstelle einbezogen; Sie können sie in Ihren Anwendungen problemlos ignorieren.

Siehe auch

CommandTargetExec-Ereignis | Aktive Dokumente

Betrifft: ActiveDoc-Objekt