Freigeben über

NEWOBJECT( )-Funktion

  • Artikel

Erstellt eine neue Klasse oder ein neues Objekt direkt aus einer VCX-Bibliothek visueller Klassen oder einem Programm.

NEWOBJECT(cClassName [, cModule [, cInApplication
   [, eParameter1, eParameter2, ...]]])

Rückgabewerte

Objekt

Parameter

  • cClassName
    Gibt die Klasse bzw. das Objekt an, aus der/dem die neue Klasse bzw. das neue Objekt erstellt wird.

    OLE-Objekte werden mit folgender Syntax für cClassName erstellt:

    ApplicationName.Class

    Wenn Sie z. B. eine Microsoft® Excel-Tabelle erstellen möchten, die die Automatisierung unterstützt, verwenden Sie die folgende Syntax:

    oExcelSheet = NEWOBJECT('Excel.Sheet')

  • cModule
    Gibt eine VCX-Bibliothek visueller Klassen oder ein Visual FoxPro-Programm (PRG, MPR, APP, EXE usw.) an, die bzw. das die unter cClassName festgelegte Klasse bzw. das Programm enthält. Standardmäßig ist eine VCX-Bibliothek visueller Klassen festgelegt; falls Sie ein Programm festlegen, müssen Sie eine Erweiterung angeben.

    Anmerkung   Eine Klassenbibliothek kann einen Alias haben. Um eine Klasse bzw. ein Objekt aus einer Klassenbibliothek mit einem Alias zu bestimmen, geben Sie den Klassenbibliotheksalias gefolgt von einem Punkt und dem Objektnamen an.

    Wird kein cModule angegeben, oder ist die Zeichenfolge leer bzw. der Wert gleich NULL, sucht Visual FoxPro in folgender Reihenfolge nach der Klasse bzw. dem Objekt:

    • Visual FoxPro-Basisklassen.
    • Klassen im aktuellen Programm.
    • Klassenbibliotheken, die mit SET CLASSLIB geöffnet wurden.
    • Klassen in Prozedurdateien, die mit SET PROCEDURE geöffnet wurden.
    • Klassen in der Visual FoxPro-Programmausführungskette.
    • Die OLE-Registrierung, wenn SET OLEOBJECT auf ON gesetzt ist.

  • cInApplication
    Gibt eine Visual FoxPro-Anwendung (EXE oder APP) an, die die mit cClassLibName festgelegte VCX-Bibliothek visueller Klassen beinhaltet. Sie müssen für diese Anwendung eine Erweiterung angeben. cInApplication wird ignoriert, wenn kein cModule angegeben wird oder wenn cInApplication die leere Zeichenkette bzw. der NULL-Wert ist.

  • eParameter1, eParameter2, ...
    Gibt optionale Parameter an, die an die Init-Ereignisprozedur für die Klassen bzw. das Objekt weitergegeben werden.

Hinweise

Mit NEWOBJECT( ) können neue Klassen bzw. neue Objekte erstellt werden, ohne eine VCX-Bibliothek visueller Klassen oder eine Prozedurdatei öffnen zu müssen.

Verwenden Sie = oder STORE, um den durch NEWOBJECT( ) erhaltenen Objektverweis einer Variablen oder einem Arrayelement zuzuordnen. Wird ein Objekt, das einer Variablen bzw. einem Arrayelement zugeordnet ist, freigegeben, so enthält die Variable bzw. das Arrayelement den NULL-Wert. Verwenden Sie RELEASE, um die Variable bzw. das Arrayelement aus dem Speicher zu löschen.

Siehe auch

Klassen-Designer | CREATE CLASS | CREATE CLASSLIB | CREATEOBJECT( ) | DEFINE CLASS | NewObject-Methode