DoVerb-Methode

Führt ein Verb für das angegebene Objekt aus.

Object.DoVerb[(Verb)]

Parameter

• Verb
  Das Verb, das für das Objekt innerhalb des OLE-Container-Steuerelements ausgeführt werden soll. Sofern keine Angabe gemacht wurde, wird das Standardverb ausgeführt. Dieses Argument kann als Wert eines der Standardverben, die von allen Objekten unterstützt werden, oder einen Index des ObjectVerbs-Eigenschaftenarrays annehmen. Jedes Objekt kann einen eigenen Satz von Verben unterstützen.

  Die folgenden Werte stellen Standardverben dar, die von allen Objekten unterstützt werden:

  Value	Maßnahme
  0	Standardaktion für das Objekt.
  –1	Aktiviert das Objekt für das Bearbeiten. Wenn die Anwendung, in der das Objekt erstellt wurde, die direkte Aktivierung unterstützt, wird das Objekt innerhalb des OLE-Container-Steuerelements aktiviert.
  –2	Öffnet das Objekt in einem eigenen Anwendungsfenster. Wenn die Anwendung, in der das Objekt erstellt wurde, die direkte Aktivierung unterstützt, wird das Objekt im eigenen Fenster aktiviert.
  –3	Für eingebettete Objekte. Blendet die Anwendung, mit der das Objekt erstellt wurde, aus.
  –4	Wenn das Objekt die direkte Aktivierung unterstützt, wird das Objekt für direkte Aktivierung aktiviert, und alle Benutzeroberflächentools werden angezeigt. Unterstützt das Objekt die direkte Aktivierung nicht, wird es nicht aktiviert, und ein Fehler tritt auf.
  –5	Übergibt der Benutzer den Fokus zu dem OLE-Container-Steuerelement, wird ein Fenster für das Objekt erstellt, und das Objekt wird auf die Bearbeitung vorbereitet. Ein Fehler tritt auf, wenn das Objekt die Aktivierung mittels eines einzigen Mausklicks nicht unterstützt.
  –6	Wird verwendet, wenn das Objekt zum Bearbeiten aktiviert wird, um alle Aufzeichnungen zu den Änderungen zu verwerfen, die die Anwendung des Objekts rückgängig machen kann.

Hinweise

Wenn Sie die AutoActivate-Eigenschaft auf 2 setzen (Doppelklick), aktiviert das OLE-Container-Steuerelement automatisch das aktuelle Objekt, wenn der Benutzer auf das Steuerelement doppelklickt.

Tipp   Sie können zwar den Namen des Verbs (edit, open, play usw.) verwenden, um das mit DoVerb auszuführende Verb anzugeben, wenn Sie den Index (0, 1, 2 usw.) verwenden, sparen Sie jedoch viel Zeit.

Beispiel

Das folgende Beispiel fügt ein OLE-Container-Steuerelement zu einem Formular hinzu und legt mit der OleClass-Eigenschaft und der DocumentFile-Eigenschaft Microsoft Excel als OLE-Server und ein Microsoft Excel-Arbeitsblatt als zu bearbeitende Datei fest.

Die DocumentFile-Eigenschaft gibt ein Arbeitsblatt mit dem Namen BOOK1.XLS im Excel-Verzeichnis auf Laufwerk C an. Wenn die in der DocumentFile-Eigenschaft angegebene Datei und das Verzeichnis nicht vorhanden sind, kann dieses Beispiel nicht fehlerfrei ausgeführt werden. Aus diesem Grund ist es möglich, dass Sie die DocumentFile-Eigenschaft so ändern müssen, dass sie auf ein vorhandenes Arbeitsblatt in einem vorhandenen Verzeichnis verweist.

* Mit der DoVerb-Methode wird das Arbeitsblatt zum Bearbeiten geöffnet.

*frmMyForm = CREATEOBJECT('form')  && Create a form
*frmMyForm.Closable = .F.  && Disable the Control menu box

frmMyForm.AddObject('cmdCommand1','cmdMyCmdBtn')  && Add Command button
frmMyForm.AddObject("oleObject","oleExcelObject")  && Add OLE object

frmMyForm.cmdCommand1.Visible=.T.  && Display the "Quit" Command button

frmMyForm.oleObject.Visible=.T.  && Display the OLE control
frmMyForm.oleObject.Height = 50  && OLE control height

frmMyForm.Show  && Display the form

frmMyForm.oleObject.DoVerb(-1)  && -1 for Edit

READ EVENTS  && Start event processing

DEFINE CLASS oleExcelObject as OLEControl
   OleClass ="Excel.Sheet"  && Server name
   DocumentFile = "C:\EXCEL\BOOK1.XLS"  && This file must exist 
ENDDEFINE

DEFINE CLASS cmdMyCmdBtn AS CommandButton  && Create Command button
   Caption = '\<Quit'  && Caption on the Command button
   Cancel = .T.  && Default Cancel Command button (Esc)
   Left = 125  && Command button column
   Top = 210  && Command button row
   Height = 25  && Command button height

   PROCEDURE Click
      CLEAR EVENTS  && Stop event processing, close form
ENDDEFINE

Siehe auch

Gebundenes OLE-Steuerelement | OLE-Container-Steuerelement

Betrifft: Gebundenes OLE-Steuerelement | OLE-Container-Steuerelement