Erfassungsmodulobjekt
| Kategorie | Berichte |
|---|---|
| Klasse | cov_engine |
| Klassenbibliothek | Coverage.vcx |
| Basisklasse | Formularsatz |
| Übergeordnete Klasse | scov_formset |
Bei diesem Formularsatz handelt es sich nicht um eine Unterklasse von _formset. Deshalb ist der Erfassungsprotokoll-Profiler sowohl in Visual FoxPro 5.0 als auch in späteren Versionen funktionsfähig.
Hinweise
Diese Klasse ist eine untergeordnete Klasse der Formularsatz-Klasse von Visual FoxPro. Obwohl keine sichtbaren Komponenten zur Verfügung gestellt werden, ermöglicht diese Klasse die Datensitzung einer Formularsatz-Klasse, gibt Kommentare zur Erfassungsprotokoll-Verarbeitung aus, wie WAIT WINDOW NOWAIT und MESSAGEBOX( ), und enthält Unterklassen von MSComDlg.CommonDialog. Dieser Formularsatz besteht nur aus einem Element, und zwar aus einer Symbolleiste, die verborgen bleibt, während ein Container für benutzerdefinierte Objekte, wie CusRegistry oder Dialogfeld-Unterklassen, zur Verfügung gestellt wird. Cov_standard, eine Unterklasse von cov_engine, enthält eine Beispielbenutzeroberfläche, den Erfassungsprotokoll-Profiler. Entsprechend Ihren Anforderungen können Sie entweder cov_engine oder cov_standard als Unterklasse wählen.
aAddIns Array-Eigenschaft
Dieses eindimensionale Array enthält eine Liste registrierter Add-In-Dateien.
Standard .F. (das Array wird dimensioniert [1])
aFileTypes Array-Eigenschaft
Dieses zweidimensionale Array enthält eine Liste der Dateitypen (Erweiterungen), die vom Erfassungsprotokoll-Profiler bearbeitet werden. In der ersten Spalte steht die Erweiterung, die im Textprotokoll des Erfassungsprotokolls aufgeführt ist (zum Beispiel .fxp oder .vct). Die zweite Spalte enthält die Erweiterung der entsprechenden Quellcodedatei (zum Beispiel PRG oder VCX), die der Erfassungsprotokoll-Profiler suchen muss, um den Code analysieren zu können. Das Array wird beim Starten der Anwendung von der FillFileTypeArray( )-Methode gefüllt.
Standardeinstellung: .F. (das Array wird mit [1, 2] dimensioniert)
cAddIn-Eigenschaft
Gibt das Add-In an, das zuletzt erfolgreich ausgeführt wurde. Beim Start kann diese Eigenschaft durch ein Add-In, das als Parameter an den Erfassungsprotokoll-Profiler übergeben wurde, eingestellt werden. Dann kann sie mit Init ausgeführt werden. Falls die Namen der Add-In-Dateien bereits vorher in der Registrierung gespeichert wurden, wird die Eigenschaft mit Hilfe des aAddIns-Arrays gefüllt.
Standardeinstellung: ""
cBaseFontName-Eigenschaft
Gibt einen Basisschriftartnamen für jedes Element der Benutzeroberfläche an. Die Standardeinstellung für dieses Attribut ist die #DEFINE-Konstante COV_STANDARD_BASE_FONTNAME in COV_TUNE.H, sofern keine andere Schriftart bei der Registrierung angegeben wurde.
Standardeinstellung: MS Sans Serif
cBaseMonoFontName-Eigenschaft
Gibt einen Basisschriftartnamen für alle Elemente der Benutzeroberfläche an, für die eine Schriftart mit einfachem Abstand erforderlich ist.
Die Standardeinstellung für dieses Attribut, sofern keine andere Schriftart bei der Registrierung angegeben wurde, ist zuerst jeder Visual FoxPro Ressourcendatei-Eintrag für Einstellungen im MODIFY COMMAND-Fenster. Andernfalls sucht das Erfassungsprotokoll-Modul nach einem Visual FoxPro-Registrierungseintrag für das Testfenster. Kann einer davon nicht gefunden werden, verwendet das Erfassungsprotokoll-Modul die #DEFINE-Konstante COV_STANDARD_MONO_FONTNAME in COV_TUNE.H.
Standardeinstellung: Courier New
cCovFilesAlias-Eigenschaft
Gibt den Namen der Einfügemaske der Quelldateien an, die der Erfassungsprotokoll-Profiler nicht suchen oder analysieren soll. Das Modul füllt den Cursor mit einem Satz von Dateinamen, wobei die Methoden CreateCoverageFileNameCursor( ) und FillCoverageFileNameCursor( ) verwendet werden. Sie können die abstrakte AdjustCoverageFileNameCursor( )-Methode des Erfassungsprotokoll-Moduls dazu verwenden, dem Satz Dateinamen hinzuzufügen.
Standardeinstellung: IgnoredFiles
cStandardWritePath-Eigenschaft
Gibt den Pfad von cSourceFile an. Liefert den Standardpfad für jede Dateiausgabe des Erfassungsprotokoll-Profilers.
Standardeinstellung: ""
cMarkExecuted-Eigenschaft
Gibt das oder die Zeichen an, die Codezeilen markieren, die entsprechend dem aktuellen Erfassungsprotokoll ausgeführt wurden. Obwohl diese Eigenschaft standardmäßig eine leere Zeichenfolge verwendet, bedient sich das Modul der SetMarks( )-Prozedur, um die Länge von cMarkExecuted und cMarkNotExecuted anzugleichen, so dass die Darstellung des markierten Codes einheitlich ist. Demzufolge ist der Wert von cMarkExecuted beim Start SPACE(4), damit er mit der Standardlänge von cMarkNotExecuted übereinstimmt.
Standardeinstellung: ""
cMarkNotExecuted-Eigenschaft
Gibt das oder die Zeichen an, die Codezeilen markieren, die während des aktuellen Erfassungsprotokolls nicht ausgeführt wurden.
Standardeinstellung: |+SPACE(3)
cSavedSkipFiles-Eigenschaft
Gibt den Namen der Datenbankdatei (.dbf) an, die die Liste der Quelldateien enthält, die bei der Analyse des Erfassungsprotokolls übersprungen wurden.
Standardeinstellung: ""
cSavedTargetDBF-Eigenschaft
Gibt den Namen der Datenbankdatei (.dbf) an, die die Ergebnisse des Erfassungsprotokolls beinhaltet.
Standardeinstellung: ""
cSkippedAlias-Eigenschaft
Gibt den Namen des Cursors an, der die Namen der Quelldateien enthält, die der Erfassungsprotokoll-Profiler nicht finden oder analysieren konnte. Das Modul füllt die Einfügemaske mittels der CreateSkippedCursor( )-Methode und speichert sie mit der SaveSkippedCursor( )-Methode auf der Festplatte.
Standardeinstellung: SkippedFiles
cSourceAlias-Eigenschaft
Gibt den Namen der Quelle an, die die angefügten und verarbeiteten Datensätze enthält, die vom Textprotokoll des Erfassungsprotokolls gespeichert wurden. Das Modul erzeugt den Cursor in der CreateSourceCursor( )-Methode und stellt die abstrakte AdjustSourceCursor( )-Methode zur Verfügung, mit der Sie Felder, Indexnamen usw. hinzufügen können. Anschließend füllt das Modul den Cursor mit Datensätzen, die vom Textprotokoll in die FillSourceCursor( )-Methode übernommen werden.
Standardeinstellung: FromLog
cSourceFile-Eigenschaft
Gibt den Namen der zu analysierenden Datei an. Sie können diesen Wert als ersten Parameter des DO (_COVERAGE) WITH-Befehls speichern.
Standardeinstellung: ""
cSuspendedLog-Eigenschaft
Gibt den Namen des aktuellen Erfassungsprotokolls an (SET(COVERAGE)), wenn der Erfassungsprotokoll-Profiler die Datenprotokollierung unterbrochen hat. Die Eigenschaft wird mit der SuspendCoverage( )-Methode eingerichtet.
Standardeinstellung: ""
cTargetAlias-Eigenschaft
Gibt den Zielcursor an, der die Namen von Klassen und Quelldateien, vom Erfassungsprotokoll markierte Prozedurquellcodes und Statistiken des Erfassungsprotokolls enthält. Das Modul erzeugt den Cursor mit der CreateTargetCursor( )-Methode und stellt die abstrakte AdjustTargetCursor( )-Methode zur Verfügung, mit der Sie Felder, Tags usw. hinzufügen können. Anschließend sucht und analysiert das Erfassungsprotokoll-Modul den Quellcode in der FillTargetCursor( )-Methode.
Standardeinstellung: MarkedCode
iLenExecuting
Gibt die Länge eines Feldes in der Quellarbeitsdatei an, das Informationen über den Objekt- und Methodennamen enthält, in dem erfasste Codezeilen ausgeführt werden, wenn für die #DEFINE-Konstante COV_TOPSPEED in COV_TUNE.H die Einstellung falsch (.F.) festgelegt ist. Sie haben die Möglichkeit, den Standardwert herunterzusetzen, wenn Ihre voll qualifizierten Objekt- und Methodennamen kurz sind und Sie den Festplattenspeicher einsparen möchten, der von den Arbeitsdateien des Profilers benötigt wird. Hierbei ist allerdings Vorsicht geboten. Lesen Sie COV_TUNE.H, um nähere Informationen über den Wert zu erhalten. Weitere Informationen über die Verwendung von iLenExecuting finden Sie unter Einsparung von Festplattenspeicher während der Ausführung des Erfassungsprotokolls.
Standardeinstellung: 115
iLenDuration
Gibt die Länge (einschließlich der Dezimalstellen) des numerischen Feldes in der Quelldatei an.
Standardeinstellung: 8 (in Visual FoxPro, Versionen 5.0 und 6.0. In späteren Versionen ist die Standardeinstellung 11.)
iLenHostFile
Standardeinstellung: 115
iLenObjClass
Gibt die Länge eines Feldes in der Quell- oder Zielarbeitsdatei an, das Informationen über das Objekt enthält, das erfasste Codezeilen ausführt, wenn für die #DEFINE-Konstante COV_TOPSPEED in COV_TUNE.H die Einstellung falsch (.F.) festgelegt ist. Um den Festplattenspeicher einzusparen, der von den Arbeitsdateien des Profilers benötigt wird, können Sie den Standardwert heruntersetzen, wenn Ihre Objektnamen kurz sind. Hierbei ist allerdings Vorsicht geboten. Sie können dies sogar dann noch tun, wenn die Objektnamen durch ihre Containerhierarchie voll qualifiziert sind. Lesen Sie COV_TUNE.H, um nähere Informationen über den Wert zu erhalten. Weitere Informationen über die Verwendung von iLenObjClass finden Sie unterEinsparung von Festplattenspeicher während der Ausführung des Erfassungsprotokolls.
Standardeinstellung: 115
lBaseFontBold-Eigenschaft
Gibt ein Basisschriftartattribut (fett) für alle angezeigten Zeichen an.
Standardeinstellung:** **.F.
lBaseFontItalic-Eigenschaft
Gibt ein Basisschriftartattribut (kursiv) für alle angezeigten Zeichen an.
Standardeinstellung:** **.F.
lBaseMonoFontBold-Eigenschaft
Gibt ein Basisschriftartattribut (fett) für alle angezeigten Zeichen an, für die eine Schriftart mit einfachem Abstand erforderlich ist.
Standardeinstellung:** **.F.
lBaseMonoFontItalic-Eigenschaft
Gibt ein Basisschriftartattribut (kursiv) für alle angezeigten Zeichen an, für die eine Schriftart mit einfachem Abstand erforderlich ist.
Standardeinstellung:** **.F.
lError-Eigenschaft
Ein Attribut, das einen aufgetretenen Fehler definiert, der von der Error-Methode erkannt und von wichtigen Operationen während der Verarbeitung überprüft wurde.
Standardeinstellung:** **.F.
lInCoverageFrame-Eigenschaft
Gibt an, ob der Erfassungsprotokoll-Profiler im Hauptfenster von Visual FoxPro geöffnet werden soll. Standardmäßig zeigt der Erfassungsprotokoll-Profiler die Elemente in einem separaten Fenster an.
Standardeinstellung:** **.F.
lInProfileMode-Eigenschaft
Gibt an, ob der Erfassungsprotokoll-Profiler das Erfassungsprotokoll auf Profiling-Merkmale hin analysiert. Der Erfassungsprotokoll-Profiler untersucht das Erfassungsprotokoll standardmäßig auf diese Merkmale hin.
Standardeinstellung:** **.F.
lMarkAllOnLoad-Eigenschaft
Gibt an, ob der gesamte Quellcode markiert werden soll, wenn eine Zieldatei geladen wird. Standardmäßig werden separate Datensätze des Quellcodes markiert, und zwar einer pro Aufruf, gemäß den Anforderungen des Benutzers.
Standardeinstellung:** **.F.
lSaveFormPositions-Eigenschaft
Gibt an, ob alle Formulare im Formularsatz eine Instanz von cov_SavePosition erhalten sollen, um Position und Größe von Formularen zu behandeln.
Standardeinstellung:** **.F.
lSmartPath-Eigenschaft
Gibt an, ob das Modul einen Hinweis auf die Verzeichnisse, in denen Sie Datensätze gesucht haben, beibehalten soll.
Standardeinstellung: .T.
lStartInProfileMode-Eigenschaft
Gibt an, wie die lInProfileMode-Eigenschaft eingestellt ist, wenn das jeweilige Erfassungsprotokoll geladen wird. Dieser Wert ist von Bedeutung, wenn die Eigenschaft lMarkAllOnLoad auf wahr (.T.) gesetzt wird.
Standardeinstellung:** **.F.
lTurnedOffTrace-Eigenschaft
Gibt an, ob der Erfassungsprotokoll-Profiler während der Verarbeitung SET TRBETWEEN OFF ausgegeben hat.
Standardeinstellung:** **.F.
lUsingRegistry-Eigenschaft
Gibt an, ob Benutzeroptionen in der Microsoft Windows-Registrierung gespeichert und von dieser wiederhergestellt werden.
Standardeinstellung: .T.
lUsingStatusBar-Eigenschaft
Bestimmt, ob Kommentare während der Verarbeitung in der Statuszeile oder in einem Wartefenster des Typs WAIT WINDOW NOWAIT angezeigt werden. Die Statuszeile wird verwendet, wenn der Erfassungsprotokoll-Profiler im Visual FoxPro-Hauptfenster oder im Hintergrund ausgeführt wird und STATUS BAR auf ON gesetzt ist.
Standardeinstellung:** **.F.
lVFP5-Eigenschaft
Gibt an, ob der Erfassungsprotokoll-Profiler unter Visual FoxPro 5.0 ausgeführt wird.
Standardeinstellung: (ATC("FoxPro 05",VERSION( )) > 0)
nBasefontsize-Eigenschaft
Gibt eine Basisschriftartgröße für alle angezeigten Zeichen an.
Standardeinstellung: 8
oFrame-Eigenschaft
Gibt einen Verweis auf den Erfassungsprotokoll-Rahmen an, wenn der Erfassungsprotokoll-Profiler in einem separaten Fenster ausgeführt wird. Das Modul überprüft, ob dieses Fenster vorhanden ist, bevor darauf bezogene Dialogfelder oder andere Elemente (einschließlich gemeinsamer Dialogfeld-Unterklassen, SET TALK-Anzeige usw.) angezeigt werden.
Standardeinstellung: .NULL.
AddFormPositionSaver( )-Methode
Fügt einem Formular eine Instanz von cov_SavePosition hinzu, um Größe und Position eines Formulars zu speichern und wiederherzustellen.
AddFormPositionSaver(toForm)
Rückgabewerte
Keine (None)
Parameter
- toForm
Gibt an, dass das cov_SavePosition-Objekt in einem Formular gespeichert wird.
AddPath( )-Methode
Extrahiert Verzeichnisinformationen, um eine Verkettung zu SET(PATH) herzustellen.
AddPath(tcFileName)
Rückgabewerte
Keine (None)
Parameter
- tcFileName
Gibt den Namen einer Datei an.
Hinweise
Extrahiert die Verzeichnisinformation aus dem übergebenen Dateinamen tcFileName, um sie in den aktuellen SET(PATH) einzufügen.
AddRegisteredAddin( )-Methode
Fügt den Dateinamen in das aAddIns-Array ein.
AddRegisteredAddin(tcFileToAdd)
Rückgabewerte
Keine (None)
Parameter
- tcFileToAdd
Gibt die Datei an, die dem aAddIns-Array hinzugefügt werden soll.
Hinweise
Fügt dem aAddIns-Array den Dateinamen aus TcFileToAdd hinzu, wenn die Methode von der RunAddIn( )-Methode aufgerufen wird, nachdem ein Add-In erfolgreich ausgeführt wurde.
AdjustCoverageFilenameCursor( )-Methode
Ermöglicht das Hinzufügen von Dateien zur Liste des Cursors mit nicht analysierten Dateien.
AdjustCoverageFilenameCursor(tcTarget)
Rückgabewerte
NOT THIS*.lReturn*
Parameter
- tcTarget
Gibt den Namen des Cursors an, den Sie ändern möchten.
Hinweise
Ermöglicht das Hinzufügen von Dateien, die nicht analysiert werden sollen, zur Dateiliste des Cursors, wenn ein Aufruf durch die CreateCoverageFilenameCursor( )-Methode erfolgt. Weitere Informationen finden Sie im Abschnitt zur cCovFilesAlias-Eigenschaft.
AdjustSourceCursor( )-Methode
Diese abstrakte Methode ermöglicht es Ihnen, Indexnamen und benutzerdefinierte Felder dem Quellcursor hinzuzufügen, wenn sie von der CreateSourceCursor( )- Methode aufgerufen werden.
AdjustSourceCursor(tcSource)
Rückgabewerte
NOT THIS*.lReturn*
Parameter
- tcSource
Gibt den Namen des Cursors mit den Quelldatensätzen an.
AdjustTargetCursor( )-Methode
Diese abstrakte Methode, die von der CreateTargetCursor( )-Methode aufgerufen wird, ermöglicht es Ihnen, Indexnamen und benutzerdefinierte Felder zum Zielcursor hinzuzufügen.
AdjustTargetCursor(tcTarget)
Rückgabewerte
NOT THIS*.lReturn*
Parameter
- tcTarget
Gibt den Namen der Tabelle an, die gerade geändert wird.
ClearStatus( )-Methode
Entfernt eine Meldung aus der Statusleiste oder führt einen CLEAR WAIT WINDOW-Befehl aus. Weitere Informationen finden Sie im Abschnitt zur IUsingStatusBar-Eigenschaft.
ClearStatus( )
Rückgabewerte
Keine (None)
Parameter
Keine (None)
CreateCoverageFilenameCursor( )-Methode
Erzeugt einen Cursor, der die Namen von Quelldateien enthält, die der Erfassungsprotokoll-Profiler nicht suchen oder analysieren soll. Weitere Informationen finden Sie im Abschnitt zur cCovFilesAlias-Eigenschaft.
CreateCoverageFileNameCursor( )
Rückgabewerte
lReturn und NOT THIS.lError
Parameter
Keine (None)
CreateForms( )-Methode
Beim Start wird das Fenster des Erfassungsprotokoll-Profilers angezeigt, wenn die Arbeitsdateien eingerichtet wurden, sofern das Erfassungsprotokoll-Modul nicht im unbeaufsichtigten Modus ausgeführt wird. In der Basisklasse des Erfassungsprotokoll-Moduls erstellt diese Methode nur das Fenster des Erfassungsprotokolls (wenn das Modul nicht im Hauptfenster von Visual FoxPro ausgeführt wird). Durch Unterklassen kann diese Methode so erweitert werden, dass eigene Dialogfelder hinzufügt werden können.
CreateForms( )
Rückgabewerte
Keine (None)
Parameter
Keine (None)
CreateSkippedCursor( )-Methode
Das Modul erzeugt diesen Cursor durch Suchen nach gelöschten Datensätzen in der Quelltabelle, da übersprungene Datensätze gelöscht werden, wenn das Modul Dateinamen feststellt, die nicht mehr zu finden sind oder beim Laden der Protokolldatei auf der Liste der zu ignorierenden Dateien stehen. Weitere Informationen finden Sie im Abschnitt zur CSkippedAlias-Eigenschaft.
CreateSkippedCursor(tcSource, tcSkipped)
Rückgabewerte
NOT THIS.lError
Parameter
- tcSource
Gibt den Namen der Tabelle an, die die Quelldatensätze enthält. - TcSkipped
Gibt den Alias des Cursors mit den übersprungenen Datensätzen an.
CreateSourceCursor( )-Methode
Erzeugt eine Quell-Einfügemaske im folgenden Format:
CREATE CURSOR(cSource) ;
(Duration n(COV_LEN_DURATION,N_COVLOG_PRECISION), ;ObjClass c(COV_LEN_OBJCLASS), ;Executing c(COV_LEN_EXECUTING), ;Procline i, ;Hostfile c(COV_LEN_HOSTFILE), ;Stacklevel I, ;FileType c(4) )
Das Feld Stacklevel wird nicht eingeschlossen, wenn der Wert der lVFP5-Eigenschaft wahr (.T.) ist. Weitere Informationen über #DEFINE-Feldlängen finden Sie unter COV_TUNE.H.
CreateSourceCursor(tcSource)
Rückgabewerte
lReturn und NOT THIS.lError
Parameter
- tcSource
Gibt den Namen des Cursors mit den Quelldatensätzen an.
CreateTargetCursor( )-Methode
Erzeugt eine Ziel-Einfügemaske im folgenden Format:
CREATE CURSOR (cTarget) ;
(Hostfile c(COV_LEN_HOSTFILE), ;ObjClass c(COV_LEN_OBJCLASS), ;FileType c(4), ;Marked m, ;Profiled m, ;SourceCode m, ;Coverable i, ;Covered i, ;ObjTotal i, ;ObjHits i)
Weitere Informationen über #DEFINE-Feldlängen finden Sie unter COV_TUNE.H.
CreateTargetCursor(tcSource, tcTarget)
Rückgabewerte
NOT THIS.lError
Parameter
- tcSource
Gibt den Namen der Datei an, die analysiert werden soll. - TcTarget
Gibt den Namen der Datei an, die Sie ändern möchten.
Hinweise
Die Zieldatei enthält einen Datensatz für jede der folgenden Elemente im Erfassungsprotokoll:
- Eine Zieldatei im ASCII-Format.
- Eine in einer Zieldatei im ASCII-Format enthaltene Klasse.
- Eine in einer .vcx oder .scx-Datei enthaltene Klasse.
- Eine in einer .dbc-Datei gespeicherte Prozedurliste.
- Eine in einer .frx oder .lbx Quelldatei enthaltene Datenumgebung-Klasse oder eine andere Datenumgebungselement-Klasse (zum Beispiel eine Einfügemaske).
DeleteRegisteredAddin( )-Methode
Entfernt einen Dateinamen aus dem aAddIns-Array.
DeleteRegisteredAddin(tcFileToDelete)
Rückgabewerte
Keine (None)
Parameter
- tcFileToDelete
Gibt das Add-In an, das aus der Registrierung entfernt werden soll.
Hinweise
Die Methode wird von der RunAddIn-Methode aufgerufen, wenn ein Add-In nicht erfolgreich ausgeführt wurde, wobei es keine Rolle spielt, ob die Registrierung zu dem Zeitpunkt in Benutzung ist oder nicht.
DisplayProjectStatistics( )-Methode
Ermöglicht eine Anzeige der Projektstatistiken, nachdem sie mit GetProjectStatistics( ) zusammengefasst wurden.
DisplayProjectStatistics(tcSource, tcTarget, tcProject)
Rückgabewerte
NOT THIS.lError
Parameter
- tcSource
Gibt den Namen der Tabelle an, die die Quelldatensätze enthält. - tcTarget
Gibt den Namen der Tabelle an, die gerade geändert wird. - tcProject
Gibt den Alias des Projekts an, das gerade analysiert wird.
DoMessage( )-Methode
Zeigt die Meldung tcMessage an.
DoMessage(tcMessage [, tnMessageBoxOptions [, tcMessageBoxTitle]])
Rückgabewerte
liReturn
Parameter
- tcMessage
Gibt die Meldung an, die in der MESSAGEBOX erscheint. - TnMessageBoxOptions
Gibt die Einstellung von MESSAGEBOX nDialogBoxType an. - TcMessageBoxTitle
Gibt die Einstellung von MESSAGEBOX cTitleBarText an. - LiReturn
Gibt jeden Rückgabewert von MESSAGEBOX( ) an oder 0, wenn ein Wartefenster (WAIT WINDOW) ausgeführt wird.
Hinweise
Wenn der Erfassungsprotokoll-Profiler im unbeaufsichtigten Modus ausgeführt wird, wird die Meldung in einem TIMEOUT-Wartefenster angezeigt, so dass eine weitere Verarbeitung nicht verhindert wird. Sie haben die Möglichkeit, den Wert für die Zeitüberschreitung durch Verwendung von COV_TIMEOUT_SECS (eine #DEFINE-Konstante in COV_TUNE.H) festzulegen.
Error( )-Methode
Setzt das Attribut für einen Dialogfeld-Fehler.
Error(nError, cMethod, nLine)
Rückgabewerte
Keine (None)
Parameter
- nError
Gibt die Nummer des Visual FoxPro-Fehlers an. - CMethod
Gibt den Namen der Methode an, die den Fehler verursacht hat. - NLine
Gibt die Nummer der Zeile an, in der der Fehler aufgetreten ist.
Hinweise
Abhängig vom Wert von COV_DEBUG (eine #DEFINE-Konstante in COV_TUNE.H) wird eine MESSAGEBOX für einen Fehler angezeigt und das Modul freigegeben oder es wird ein Wartefenster mit Informationen zum Fehler angezeigt und die systemeigene Visual FoxPro-Fehlerbehandlungsroutine aufgerufen, so dass Sie den aktuellen Fehler löschen, überspringen oder ignorieren können.
FillCoverageFileNameCursor( )-Methode
Fügt Dateien der Liste der ignorierten Dateien hinzu.
FillCoverageFileNameCursor( )
Rückgabewerte
NOT THIS.lError
Parameter
Keine (None)
Hinweise
CreateCoverageFileNameCursor( ) ruft diese Methode auf, um den Namen des Dateisatzes des Erfassungsprotokoll-Moduls zu der Dateigruppe hinzuzufügen, der während der Verarbeitung ignoriert werden soll. Diese Methode ist ein hart codierter Satz von INSERTs im Basiserfassungsprotokoll-Modul. Sie haben die Möglichkeit, diesen Satz mit der Hilfe einer Unterklasse zu überschreiben, die dazu entwickelt wurde, einen Satz von Dateinamen aus einer Textdatei einzulesen, die von der Dateiliste des Erfassungsprotokolls .pjx erzeugt wurde
FillFileTypeArray( )-Methode
Initialisiert das aFileTypes-Array mit bekannten Dateierweiterungen. Weitere Informationen finden Sie im Abschnitt zur aFileTypes-Eigenschaft.
FillFileTypeArray( )
Rückgabewerte
NOT(EMPTY(THIS.aFileTypes[1,1]) OR THIS.lError)
Parameter
Keine (None)
FillOneTargetRecord( )-Methode
Fügt in das Memofeld nicht gekennzeichneten Quellcode ein.
FillOneTargetRecord(tcSource, tcTarget, tlFillingAll)
Rückgabewerte
lReturn und NOT THIS*.lError*
Parameter
- tcSource
Gibt den Namen der Tabelle an, die die Quelldatensätze enthält. - TcTarget
Gibt den Namen der Tabelle an, die gerade geändert wird. - TlFillingAll
Gibt an, ob alle Datensätze in einer Schleife verarbeitet werden, wodurch die Benutzerrückmeldungen und die angezeigte Zeichenbehandlung geändert werden.
Hinweise
Setzt den nicht markierten Quellcode für einen Zieldatensatz in das entsprechende Memofeld, in dem er zu einem späteren Zeitpunkt durch Verwendung einer anderen Strategie markiert wird, um den richtigen Code für jeden Quellcodetyp zu finden. Wenn die #DEFINE-Konstante COV_TOPSPEED nicht wahr (.T.) ist, setzt diese Methode auch bestimmte Initialstatistiken in die Zieldatei.
FillSourceCursor( )-Methode
Fügt der Quelldatei der Erfassungsprotokollanalyse den Inhalt des Erfassungsprotokolls hinzu (APPEND).
FillSourceCursor(tcSource)
Rückgabewerte
lReturn
Parameter
- tcSource
Gibt den Namen der Quelldatei an.
Hinweise
Diese Methode ruft die SourceAvailable( )-Methode auf, mit deren Hilfe Datensätze gelöscht werden, die auf Quelldateien verweisen, die nicht zur Analyse zur Verfügung stehen. Die in der Quell-Einfügemaske gelöschten Datensätze werden markiert.
FillTargetCursor( )-Methode
Ruft die FillOneTargetRecord( )-Methode für alle Zieldatensätze in einer Schleife auf.
FillTargetCursor(tcTarget)
Rückgabewerte
(THIS*.iTargetReccount >* 0**und NOT THIS*.lError*)
Parameter
- tcTarget
Gibt die Zieldatei für die verarbeiteten Ergebnisse an.
Hinweise
Repliziert die ObjHits-Statistiken der CreateTargetCursor( )-Methode für weitere Datensätze, die auf die selben Quell- und Zieldateien verweisen. Weitere Informationen finden Sie im Abschnitt zur CreateTargetCursor( )-Methode.
FilterListByLocation( )-Methode
Stellt einen Platzhalter für zukünftige Erweiterungen zur Verfügung.
FilterListByLocation( )
Rückgabewerte
NOT THIS.lError
Parameter
Keine (None)
Hinweise
Die FilterListByLocation( )-Methode kann entweder aufgerufen werden, wenn ein Protokoll geladen wird oder als Reaktion auf eine Benutzeraktion, wobei es keine Rolle spielt, ob der Erfassungsprotokoll-Profiler verwendet wird oder nicht. Diese Methode ist in abstrakter Form im Modul enthalten.
GetAlias( )-Methode
Gibt den aktuellen oder den Standardalias eines vom Erfassungsprotokoll-Profiler verwendeten Arbeitsdateityps zurück.
GetAlias(tAlias, tcWhichProp)
Rückgabetypen
cReturn
Parameter
- tAlias
Gibt den Alias einer Datei an. - tcWhichProp
Gibt den Arbeitsdateityp (momentan entweder Quelle oder Ziel) für die aktuelle Standardeinstellung zurück.
Hinweise
Die GetAlias( )-Methode gibt entweder einen zur Zeit benutzten Alias oder den Standardalias eines vom Erfassungsprotokoll-Profiler verwendeten Arbeitsdateityps zurück. Folgende Arbeitsdateitypen sind gültig:
SOURCE, TARGET, SKIPPED, COVFILES und PROJECT
(Die Liste der Dateitypen ist in der #DEFINE-Konstante COV_SPEC.H in COV_KNOWN_ALIAS_PROPERTIES enthalten.) Für jeden Arbeitsdateityp gibt es eine c…Alias-Eigenschaft, die den Standardalias für die entsprechende Arbeitsdatei angibt.
Der Erfassungsprotokoll-Profiler hält üblicherweise eine Einfügemaske durch die Verwendung aller Standardalias der Arbeitsdateien geöffnet. Der Erfassungsprotokoll-Profiler besitzt jedoch die Fähigkeit, in seiner Datensitzung viele Arbeitsdateisätze gleichzeitig zu behandeln, solange Sie separate Alias für jede Arbeitsdatei angeben. Die GetAlias( )-Methode und das System der definierten Arbeitsdateitypen zusammen mit den c…Alias-Eigenschaften ermöglichen es Ihnen, Standardaliasnamen zu verwenden, ohne dass diese fest codiert zu sein brauchen.
Die Modulmethoden, die die Arbeitsdateien verarbeiten, verwenden die Alias als Parameter. Dadurch wird es Ihnen ermöglicht anzugeben, an welcher Quell-, Ziel- oder anderen Datei Sie zum jeweiligen Zeitpunkt interessiert sind. Da Sie jedoch normalerweise nur an einem Satz von Arbeitsdateien interessiert sind, verwenden diese Methoden die GetAlias( )-Methoden, um anzugeben, welcher Alias und welcher Standard-Arbeitsdateityp gesucht werden soll, wenn Sie keine(n) spezifischen Alias angeben.
GetFontsFromUser( )-Methode
Erstellt eine Instanz einer gemeinsame Dialogfeld-Unterklasse, mit der der Benutzer darum gebeten wird, die Schriftarteigenschaften festzulegen. Ist für lUsingOCXs falsch (.F.) festgelegt oder tritt ein Fehler beim Erstellen einer Instanz der gemeinsamen Dialogfeld-Unterklasse auf, verwendet die Methode die Getfont( )-Methode. Ist der erste Parameter (tlBaseMonoFont) wahr (.T.), zeigt die Methode nur Schriftarten mit einfachen Abständen an und füllt die Attributeigenschaften dieser Schriftarten des Moduls. Ist der Parameter falsch (.F.), wird der zweite Satz der Attributeigenschaften für Basisschriftarten aus einer Liste aller zur Verfügung stehenden Bildschirmschriftarten gefüllt.
Weitere Informationen über die lUsingOCXs-Eigenschaft finden Sie im Abschnitt zur GetResourceLocation( )-Methode.
GetFontsFromUser(tlBaseMonoFont, toMemberHost )
Rückgabewerte
lFontChange und NOT THIS.lError
Parameter
- tlBaseMonoFont
Gibt die Standard-Festbreitenschriftart an. - ToMemberHost
Gibt einen Verweis auf das aktuelle Erfassungsprotokoll-Objekt an.
GetProjectStatistics( )-Methode
Erstellt einen Cursor, der Projektinformationen enthält.
GetStatistics(tcSource, tcTarget, tcProject)
Rückgabewerte
lReturn
Parameter
- tcSource
Gibt den Namen des Alias an, der die Quelldatensätze enthält. - tcTarget
Gibt den Namen des Alias an, der gerade geändert wird. - tcProject
Gibt das Projekt an, das die Quelldateien enthält.
Hinweise
Die im Cursor enthaltenen Informationen haben folgendes Format:
CREATE CURSOR(cProject) ;
(Hostfile c(COV_LEN_HOSTFILE), ;FileType c(4), ;Coverable n(8), ;Covered n(8), ;ObjTotal n(8), ;ObjHits n(8))
Die GetProjectStatistics( )-Methode erstellt in diesem Cursor eine Headerdatei, wobei das Projekt angegeben wird, auf das sich der Cursor bezieht. Der Cursor wird mit statistischen Daten gefüllt, die aus dem aktuellen Erfassungsprotokoll stammen und sich auf die einzelnen Quelldateien im Projekt beziehen. Falls nötig, wird von der GetProjectStatistics( )-Methode die MarkOneTargetRecord( )-Methode für alle Projektdateien aufgerufen, deren Quellcode noch nicht markiert wurde.
GetRegisteredAddins( )-Methode
Füllt das aAddIns-Array und die cAddIn-Eigenschaft.
GetRegisteredAddins( )
Rückgabewerte
Keine (None)
Parameter
Keine (None)
GetRegistryKeyValue( )-Methode
Ruft den Registrierungswert der Benutzeroption ab.
GetRegistryKeyValue(tcOption, tDefaultValue, tcPath)
Rückgabewerte
vReturn
Parameter
- tcOption
Gibt die Option für den Dateityp an. - tDefaultValue
Gibt den Standardregistrierungswert an. - tcPath
Gibt RegKey an.
Hinweise
Diese Methode, die normalerweise beim Start verwendet wird, benutzt das Registrierungsbehandlungselement der Symbolleiste des Modulformularsatzes, um einen Registrierschlüsselwert für eine Benutzeroption abzurufen. Falls erforderlich, wird der Registrierungswert in andere TYPE( )-Werte konvertiert und der TYPE( )-Wert mit dem übergebenen Wert (tDefaultValue) verglichen. Es wird entweder der Registrierungswert oder der Standardwert zurückgegeben, wenn der Registrierungswert nicht gefunden werden kann oder vom falschen Typ ist.
GetResourceLocation( )-Methode
Gibt an, ob die GETFILE( )/ShowOpen( )-Strategie oder die PUTFILE( )/ShowSave( )-Strategie befolgt wird.
GetResourceLocation(tcHost, tcTitle, tcCDLFilter, tcFileName, tcWhichDialog,[toMemberHost])
Rückgabewerte
lcFileName
Parameter
- tcHost
Gibt den Namen der Datei an, von der aus die Methode normalerweise startet und mit dem Suchen des entsprechenden Dateinamens der nicht kompilierten Version des Codes beginnt. Wird der Parameter übergeben, werden Informationen für die gemeinsame Dialogfeld-Eigenschaft .InitDir in korrekter Weise zur Verfügung gestellt. - tcTitle
Gibt den Titel an, der für das Dialogfeld verwendet wird oder aber in der GETFILE( )/PUTFILE( )-Version für die NOWAIT-Eingabeaufforderung in einem Wartefenster verwendet wird. Wenn tcHost ebenfalls übergeben wird und ein Dateiname enthalten ist, werden diese Informationen dem Dialogfeldtitel oder der Eingabeaufforderung hinzugefügt. - tcCDLFilter
Gibt die im Dialogfeld zulässigen Dateitypen an. Dieser Parameter wird in dem Format ausgedrückt, das vom gemeinsamen Dialogfeld-Filterausdruck benötigt wird. Wird GETFILE( )/PUTFILE( ) aufgerufen, zergliedert die Methode den gemeinsamen Dialogfeldfilter, um ihn für die beiden Visual FoxPro-Funktionen in ein passendes Format zu bringen. - tcFileName
Gibt den Standarddateinamen an, der angezeigt werden soll. - tcWhichDialog
Gibt GETFILE oder PUTFILE an. - toMemberHost
Gibt einen optionalen Formularverweis an, der übergeben werden kann, um festzulegen, wo das Dialogfeld angezeigt werden soll. Wenn toMemberHost nicht übergeben wird, wird das Dialogfeld der Datei in einem bestimmten Verhältnis zum Fenster des Erfassungsprotokolls (sofern ein solches Fenster vorhanden ist) oder zum ersten Formular in der Formularsatzauflistung angezeigt (wenn der Erfassungsprotokoll-Profiler im Hauptfenster von Visual FoxPro ausgeführt wird).
Hinweise
Sie fügt ein Element der entsprechenden gemeinsamen Dialogfeld-Unterklasse hinzu (abhängig vom Wert von tcWhichDialog), wenn sie zum ersten Mal aufgerufen wird. Die Dialogfeld-Unterklassen unterscheiden sich darin, in welcher Weise sie verschiedene Attribute setzen.
Anmerkung Beachten Sie, dass diese Methode zusätzliche Dialogfeld-Unterklassen zur Verfügung stellt, die eine Hilfedatei oder einen Druckdialog zur Instantiierung und zukünftigen Verwendung enthalten.
Wenn ein gemeinsamer Dialogfeld-Unterklassen- oder ein .ocx-verknüpfter Fehler im Erfassungsprotokoll-Profiler auftreten, setzt diese Methode die lUsingOCXs-Eigenschaft auf falsch (.F.) und verwendet GETFILE( )/PUTFILE( ).
Sie können die #DEFINE-Konstante COV_USE_OCXS setzen, wenn Sie die Standardfunktionen den systemeigenen Funktionen von Visual FoxPro vorziehen, auch wenn keine OCX-Fehler auftreten.
GetTableName( )-Methode
Erzeugt Dateinamen für den unbeaufsichtigten Modus.
GetTableName(tcWhichSuffix)
Rückgabewerte
cLogfileStem+SUFFIX[+n]+.dbf
Parameter
- tcWhichSuffix
Gibt an, welche Dateierweiterung verwendet wird.
Hinweise
Diese Methode ermöglicht es dem Erfassungsprotokoll-Modul, Dateinamen zu erzeugen, unter denen die Arbeit des Moduls auf der Festplatte gespeichert wird, ohne bereits vorhandene Dateien zu überschreiben. Normalerweise werden nur Standarddateinamen erstellt. Wird das Programm jedoch im unbeaufsichtigten Modus ausgeführt, erstellt die Methode die Dateinamen ohne Eingreifen des Benutzers. Jede Methode, die eine Datei auf der Festplatte speichert, ruft GetTableName( ) mit einem bestimmten Suffix auf; Beispiel SaveSkippedCursor:
cDBFName = ; THIS.GetTableName(COV_SKIPFILEDBF_SUFFIX)
GetTableName( ) verwendet den Pfad und Stamm des aktuellen Dateinamens des Protokolls (THIS.cSourceFile) und fügt diesem Stamm ein geeignetes Suffix und eine Ziffer hinzu, gefolgt von der Erweiterung .dbf. Nehmen wir beispielsweise an, dass im obigen Beispiel Testlog.txt die Datei TESTLOG_SKIP1.DBF erzeugt.
Dann erhöht GetTableName( ) die Ziffer, wenn der erzeugte Dateiname bereits vorhanden ist, bis es einen Namen findet, der noch nicht existiert.
Die Standardsuffixe sind #DEFINE-Konstanten in COV_TUNE.H.
LockScreens( )-Methode
Sperrt LockScreen- und MousePointer-Eigenschaften für alle Elemente von _Screen während verschiedener langer Prozeduren oder gibt sie frei.
LockScreens(tlOn)
Rückgabewerte
Logisch .T.
Parameter
- tlOn
Gibt an, ob die Eigenschaften Lockscreen und MousePointer gesperrt werden sollen.
MarkAllTargetRecords( )-Methode
Ruft die MarkOneTargetRecord( )-Methode für alle Zieldatensätze in einer Schleife auf. Sie kann aufgerufen werden, wenn lMarkAllOnLoad wahr (.T.) ist oder wenn das Erfassungsprotokoll-Modul im unbeaufsichtigten Modus ausgeführt wird.
MarkAllTargetRecords(tcSource, tcTarget)
Rückgabewerte
NOT THIS.lError
Parameter
- tcSource
Gibt den Namen der Tabelle an, die die Quelldatensätze enthält. - tcTarget
Gibt den Namen der Tabelle an, die gerade geändert wird.
MarkCodeLine( )-Methode
Erzeugt eine markierte Version einer Codezeile sowie zusätzliche Statistiken des Erfassungsprotokolls.
MarkCodeLine(tcLine, tiExecuted, tnFirst, tnAverage)
Rückgabewerte
CMarkedLine
Parameter
- tcLine
Gibt die Codezeile an. - tiExecuted
Gibt an, wie oft tcLine ausgeführt wurde. - tnAverage
Gibt die durchschnittliche Dauer der Ausführung an.
Hinweise
Im Erfassungsprotokoll-Modus markiert die MarkCodeLine( )-Methode den Code als ausgeführt (Executed), wenn tiExecuted eine positive Zahl ist, und als nicht ausgeführt (not Executed), wenn tiExecuted0 ist. Im Profile-Modus werden die Statistiken des Erfassungsprotokolls in der entsprechenden Zeile markiert. In jedem Modus wird mit MarkCodeLine( ) Code als nicht erfassbar (durch vorstehende Leerzeichen) markiert, wenn für tiExecuted der Wert .NULL festgelegt ist.
MarkOneTargetRecord( )-Methode
Legt den Markierungsstatus für die aktuelle Zeile fest.
MarkOneTargetRecord(tcSource, tcTarget, tlFillingAll)
Rückgabewerte
lReturn und (NOT THIS*.lError)*
Parameter
- tcSource
Gibt den Namen der Tabelle an, die die Quelldatensätze enthält. - tcTarget
Gibt den Namen des Datensatzes an, der geändert wird. - tlFillingAll
Gibt an, ob gerade andere Zieldatensätze verarbeitet werden. Werden alle Datensätze in einer Schleife verarbeitet, ändern sich die Benutzerrückmeldung und die Behandlung der angezeigten Zeichen.
Hinweise
Legt fest, ob der aktuelle Zieldatensatz tcTarget bereits im aktuellen Erfassungsprotokoll-Modus markiert ist. Ist dies nicht der Fall, werden die relevanten Informationen zur Verarbeitung der MarkTargetCoverage( )-Methode übergeben.
MarkTargetCoverage( )-Methode
Markiert eine Kopie der Quelle und ersetzt (mit REPLACE) ein Memofeld in der Zieldatei.
MarkTargetCoverage(tcSource, tcTarget)
Rückgabewerte
NOT (EMPTY(cMemo) OR THIS.lError)
Parameter
- tcSource
Gibt den Namen der Tabelle an, die die Quelldatensätze enthält. - tcTarget
Gibt den Namen der Tabelle an, die gerade geändert wird.
Hinweise
Die MarkTargetCoverage( )-Methode erzeugt eine markierte Version von tcSource und ersetzt (mit REPLACE) ein Memofeld in der Zieldatei tcTarget (dabei spielt es keine Rolle, ob es sich um Code für eine Klasse oder für eine Vollprozedurdatei handelt).
Um diese Aktion durchzuführen, beginnt die Methode mit dem Quellcode-Memofeld. Welcher Memofeldtyp verwendet wird, hängt davon ab, ob der Erfassungsprotokoll-Profiler die Profiler- oder die Erfassungsprotokollinformationen markiert, da der Zieldatensatz beide Sätze des markierten Codes beibehält. Diese Methode zergliedert den Quellcode und bewertet dessen Statistiken Zeile für Zeile. Die Methode ruft standardmäßig die MarkCodeLine( )-Methode auf, um jede Zeile zu markieren, sobald sie über die entsprechenden Statistiken verfügt. Die Art und Weise, in der die Methode die Codezeilen markiert, ist als COV_MARK_CODE_LINE-#DEFINE-Konstante in COV_TUNE.H definiert, wird jedoch nicht direkt als Aufruf der MarkCodeLine( )-Methode ausgeführt. Dies gibt Ihnen die Möglichkeit, den Aufruf der MarkCodeLine( )-Methode durch ein anderes Markierungssystem zu ersetzen. Eine zweite Option, die #DEFINE-Konstante COV_TOPSPEED in COV_TUNE.H, ermöglicht es Ihnen außerdem, den MarkCodeLine( )-Aufruf zum Erreichen der schnellsten Antwortzeit auf ein einfacheres Inline-Markierungssystem umzuschalten.
Die MarkTargetCoverage( )-Methode bewertet jede Zeile, um herauszufinden, ob sie im Profile-Modus ausgeführt wurde, wie oft sie ausgeführt wurde und wie viel Zeit das Ausführen der Zeile benötigt hat (erste Ausführung und Durchschnittswert). Viele Zeilen werden jedoch im Erfassungsprotokoll-Profiler als nicht erfassbar markiert. Diese Zeilen, wie z. B. Kommentare, DEFINE CLASS- und ELSE/Otherwise-Anweisungen, sowie Zeilen innerhalb von TEXT … ENDTEXT erscheinen nicht in Erfassungsprotokollen, da sie nicht ausführbar sind.
Anmerkung Weitere nicht erfassbare Codezeilen sind #DEFINE-Anweisungen, leere Zeilen, Fortsetzungen von gerade ausgeführten Zeilen und Parameterzeilen.
Diese Methode legt fest, wie oft diese Zeilen mit .NULL. ausgeführt werden. Die Zeilen werden nicht berücksichtigt, wenn der Erfassungsprotokoll-Profiler die Statistiken ergänzt. Ebenso werden Zeilen, die durch Fortsetzungszeichen (Strichpunkte) unterbrochen sind, als eine Codezeile betrachtet. In diesem Fall wird nur die letzte Zeile markiert.
OrderListByTime( )-Methode
Stellt einen Platzhalter für zukünftige Erweiterungen und Unterklassen zur Verfügung.
OrderListByTime( )
Rückgabewerte
NOT THIS.lError
Parameter
Keine (None)
Hinweise
OrderListByTime( ) liegt im Modul in abstrakter Form vor.
PassedProperParams( )-Methode
PassedProperParams(tcFile, tlUnattended, tcAddIn)
Rückgabewerte
lReturn
Parameter
- tcFile
Gibt den Namen der Protokolldatei an. - tlUnattended
Gibt an, ob die Aktion im unbeaufsichtigten Modus durchgeführt werden soll. - tcAddIn
Gibt den oder die Dateinamen des Add-Ins an.
Hinweise
Führt beim Start einen Test durch, um festzustellen, ob die übergebenen Parameter für die Klasse geeignet sind. Wenn übergebene Parameter einen ungeeigneten Wert für TYPE( ) haben, erscheint eine MESSAGEBOX, in der angegeben wird, welche Parameter übergeben werden können. Außerdem wird falsch (.F.) zurückgegeben, was jede weitere Erfassungsprotokoll-Verarbeitung sowie die Erstellung einer Instanz der Klasse verhindert.
Diese Methode verwendet eine MESSAGEBOX für Rückmeldungen und beendet die Verarbeitung auch dann, wenn der Erfassungsprotokoll-Profiler mit seinen Aktivitäten im Hintergrund beginnt. Wenn Sie den Erfassungsprotokoll-Profiler für die Durchführung automatischer Tests einrichten, vergewissern Sie sich, dass Ihr Aufrufprogramm korrekte Parameter versendet. Andernfalls wird die Analyse unterbrochen.
RestoreCoverage( )-Methode
Stellt nach einer Unterbrechung die Erfassungsprotokollierung wieder her.
RestoreCoverage( )
Rückgabewerte
Keine (None)
Parameter
Keine (None)
Hinweise
Wenn der Erfassungsprotokoll-Profiler bei früheren Durchgängen die Verarbeitung des Erfassungsprotokolls unterbrochen hat, bietet diese Methode den Benutzern die Möglichkeit, die Erfassungsprotokoll-Verarbeitung wiederaufzunehmen, wo der Erfassungsprotokoll-Profiler mit der Verarbeitung aufgehört hat. Der Benutzer kann entweder das frühere Protokoll überschreiben, neue Protokolleinträge hinzufügen oder zu diesem Zeitpunkt keine Erfassungsprotokollierung durchführen.
RunAddin( )-Methode
Führt eine Add-In-Datei aus.
RunAddin(tcAddin)
Rückgabewerte
lReturn und NOT THIS*.lError*
Parameter
- tcAddin
Gibt den Namen der Datei an, die ausgeführt werden soll.
Hinweise
Mit der RunAddin( )-Methode wird eine Datei mit der Erweiterung .SCX, .FXP, .APP, .PRG, .QPX, .QPR, .MPX oder .MPR ausgeführt, über die dem Erfassungsprotokoll-Objekt Funktionalität hinzufügt wird. Wird kein Dateiname übergeben, dann führt RunAddin( ) die Datei aus, die in der cAddIn-Eigenschaft angegeben wurde.
Die mit **tcAddin****festgelegte Datei muss einen Objektverweis akzeptieren, da sie durch Übergabe eines Verweises an das Erfassungsprotokoll-Formular ausgeführt wird. Sehen Sie sich hierzu die folgenden Beispiele an (abhängig vom Dateityp):
DO (cFileName) WITH THIS
DO FORM (cFileName) WITH THIS
SaveFormsetAttributes( )-Methode
Speichert bei Beendigung des Profilers allgemeine Merkmale des Rahmens und Formularsatzes in der Registrierung.
SaveFormsetAttributes( )
Rückgabewerte
Keine (None)
Parameter
Keine (None)
SaveOptionsToRegistry( )-Methode
Speichert die aktuellen Benutzerwerte in der Registrierung.
SaveOptionsToRegistry( )
Rückgabewerte
lSuccess
Parameter
Keine (None)
Hinweise
Die SaveOptionsToRegistry( )-Methode kann jederzeit aufgerufen werden, wenn die aktuellen Werte des Benutzers in der Registrierung gespeichert werden sollen. Folgende Benutzereinstellungen werden gespeichert:
- Arbeitsoptionsfeldgruppe
IStartInProfileModelSmartPathlMarkAllOnLoadcMarkExecutedcMarkNotExecutedlRegisterAddIn - UI-Optionsfeldgruppe
Name der Schriftart, Größe, kursiv, Fett für Basisschriftarten mit einfachem Abstand
Es gibt einige Registrierungseinstellungen, die von dieser Methode nicht gespeichert werden, da sie zu bestimmten Zeitpunkten während der Arbeitsdauer des Moduls eingerichtet werden müssen. Zu diesen Einstellungen gehören:
Das Fenster des Erfassungsprotokolls bzw. das Visual FoxPro-Hauptfenster (muss eingerichtet werden, wenn der Benutzer eine Auswahl trifft, die in der nächsten Sitzung wirksam werden soll, jedoch keinen der Werte der Erfassungsprotokoll-Eigenschaft für diese Sitzung entspricht und diese Werte auch nicht beeinflusst).
Registrierte Add-Ins (dieses Array wird während der Dauer der Sitzung verändert und der volle Satz der Dateinamen, die es enthält, wird am Ende der Sitzung in der Registrierung gespeichert).
SaveSkippedCursor( )-Methode
Speichert den Cursor mit übersprungenen Dateien auf Festplatte.
SaveSkippedCursor(tcSkipped)
Rückgabewerte
RETURN NOT THIS.lError
Parameter
- tcSkipped
Gibt den Cursor an, der übersprungene Datensätze enthält.
Hinweise
Speichert den Cursor, der die übersprungenen Dateien enthält, auf Festplatte, wenn er Datensätze enthält, und setzt den Namen der Tabelle auf der Festplatte in die cSavedSkipFiles-Eigenschaft. Weitere Informationen finden Sie in den Abschnitten zu den Eigenschaften cSkippedAlias und cSavedSkipFiles.
SaveTargetToDisk( )-Methode
Speichert die Ausgabedatei mit dem markierten Code und den Statistiken auf der Festplatte.
SaveTargetToDisk(tcTarget)
Rückgabewerte
lReturn und NOT THIS*.lError*
Parameter
- tcTarget
Gibt den Namen der modfizierten Tabelle an, die auf Festplatte gespeichert wurde.
SetFontValues( )-Methode
Richtet Ausgangsschriftart-Attributwerte durch die Verwendung von Registrierschlüssel- und anderen Standardwerten ein.
SetFontValues( )
Rückgabewerte
NOT THIS.lError
Parameter
Keine (None)
Hinweise
Weitere Informationen darüber, wie das Erfassungsprotokoll-Modul zu diesen Standardwerten kommt, finden Sie in den Abschnitten zu den Eigenschaften cBaseFontName und cBaseMonoFontName.
SetFormsetAttributes( )-Methode
Liest die allgemeinen Merkmale von Rahmen und Formularsätzen und stellt sie wieder her.
SetFormsetAttributes( )
Rückgabewerte
Keine (None)
Parameter
Keine (None)
Hinweise
Liest beim Starten des Profiles die allgemeinen Merkmale von Rahmen und Formularsätzen aus der Registrierung und stellt sie wieder her.
SetLogFile( )-Methode
Versucht, eine Datei für eine Analyse einzurichten.
SetLogFile(tcFile)
Rückgabewerte
lReturn
Parameter
- tcFile
Gibt den Namen der Datei an, die analysiert werden soll.
Hinweise
Wenn Sie keine Zeichenfolgewerte übergeben, wird der SET COVERAGE-Wert verwendet. Wenn keine aktuelle Protokolldatei vorhanden ist, wird von der Methode die Eingabe eines Dateinamens gefordert. Kann eine Protokolldatei erfolgreich eingerichtet werden, gibt die Methode .T. (wahr) zurück. Wenn der Benutzer keine Protokolldatei angibt, gibt die Methode .F. (falsch) zurück. Wird kein neues Protokoll festgelegt, kehrt das Erfassungsprotokoll-Modul zum aktuell geladenen Protokoll zurück, sofern ein Protokoll geladen wurde. Falls kein Protokoll geladen wurde, wird die Aktion abgebrochen.
SetMarks( )-Methode
Synchronisiert die Werte von of cMarkExecuted und cMarkNotExecuted und gibt sie zurück.
SetMarks( )
Rückgabewerte
NOT THIS.lError
Parameter
Keine (None)
Hinweise
Synchronisiert die Längen von cMarkExecuted und cMarkNotExecuted und stellt die Werte einer oder beider Eigenschaften wieder auf die Standardeinstellung zurück, falls es sich bei den Werten nicht um Zeichen handelt oder beide Eigenschaften leer sind. Wenn in der Registrierung keine Benutzeroptionen zur Verfügung stehen, erhält diese Methode die Standardwerte von den #DEFINE-Werten COV_STANDARD_MARKNOTEXECUTED und COV_STANDARD_MARKEXECUTED, die Sie in COV_TUNE.H einstellen können. Eine dritte #DEFINE-Konstante (COV_STANDARD_MARKSPACING) sorgt dafür, dass zwischen den Markierungen und der Codezeile Leerzeichen eingefügt werden.
SetRegisteredAddins( )-Methode
Speichert die Dateinamen im aAddIns-Array unter den Werten in der Registrierung.
SetRegisteredAddins( )
Rückgabewerte
Keine (None)
Parameter
Keine (None)
SetRegistryKeyValue( )-Methode
Legt für eine Benutzeroption einen Wert für einen Registrierungsschlüssel fest.
SetRegistryKeyValue(tcWhichOption, tValue)
Rückgabewerte
NOT THIS.lError
Parameter
- tcWhichOption
Gibt die Benutzeroption an, auf die zugegriffen werden soll. - tValue
Gibt den Wert von tcWhichOption an.
Hinweise
Die SetRegistryKeyValue( )-Methode verwendet das Registrierungsbehandlungselement der Symbolleiste im Formularsatz des Moduls, um einen Registrierungsschlüsselwert einer Benutzeroption einzustellen. Sie konvertiert alle Werte in Zeichenfolgetypen, bevor sie an die Registrierungsbehandlungs-Routine übergeben werden, die für die Registrierung zuständig ist.
SetUIFonts( )-Methode
Liefert die Einstellungen für die Schriftart.
SetUIFonts( )
Rückgabewerte
NOT THIS.lError
Parameter
Keine (None)
Hinweise
Die SetUIFonts( )-Methode liegt in abstrakter Form im Modul vor und wird von SetUiOptions aufgerufen. Die Methode wurde entwickelt, um dem Benutzer die Möglichkeit zu geben, Einstellungen für Schriftarten, die in den verschiedenen Basis- und BaseMont-Schriftarteigenschaften gespeichert sind, festzulegen, so dass die Zeichen im geeigneten Format angezeigt werden.
SetUIOptions( )-Methode
Legt Optionen und Standardeinstellungen für die Benutzerschnittstelle fest.
SetUIOptions( )
Rückgabewerte
lReturn und NOT THIS*.lError*
Parameter
Keine (None)
Hinweise
Richtet die ursprünglichen UI-Optionen gemäß den Benutzer- oder Standardeinstellungen ein, nachdem die ersten Arbeitsdateien erzeugt wurden. Diese Optionsgruppe beinhaltet Schriftarten sowie das Array registrierter Add-Ins. Es wird für die UI-Anzeige und die Benutzerinteraktion mit den Arbeitsdateien benötigt, nachdem sie verarbeitet wurden.
SetUIToShowCode( )-Methode
Ermöglicht die Anzeige des aktuellen Zieldatensatzes im neuen Protokoll.
SetUIToShowCode(tcTarget)
Rückgabewerte
NOT THIS.lError
Parameter
- tcTarget
Gibt den Namen der Tabelle an, die gerade geändert wird.
Hinweise
Liegt in abstrakter Form im Modul vor und wird bei Beendigung von SetupWorkFiles( ) aufgerufen, um es UI zu ermöglichen, die aktuellen Zieldatensätze im neu geladenen Protokoll anzuzeigen.
SetUIToShowFileStates( )-Methode
Ermöglicht das Anzeigen des Ladestatus eines Protokolls.
SetUIToShowFileStates(tcSource, tcTarget)
Rückgabewerte
NOT THIS.lError
Parameter
- tcSource
Gibt den Namen der Tabelle an, die die Quelldatensätze enthält. - tcTarget
Gibt den Namen der Tabelle an, die gerade geändert wird.
Hinweise
Liegt in abstrakter Form im Modul vor und wird bei Beendigung von SetupWorkFiles( ) aufgerufen, um es UI zu ermöglichen, anzugeben, ob das Laden eines Protokolls erfolgreich verlaufen oder misslungen ist, bzw. ob es gerade versucht, ein Protokoll zu laden.
SetUpWorkFiles( )-Methode
Legt ein Erfassungsprotokoll fest und führt dafür eine Gültigkeitsprüfung durch.
SetupWorkFiles(tcLogFile, tcSource, tcTarget)
Rückgabewerte
lReturn und NOT THIS.lError
Parameter
- TcLogFile
Gibt den Namen des Textprotokolls an, das analysiert werden soll. - tcSource
Gibt den Namen der Datei an, die als Quelle verwendet werden soll. - tcTarget
Gibt den Namen des Cursors an, der gerade geändert wird.
Hinweise
Die SetUpWorkFiles( )-Methode richtet ein Erfassungsprotokoll ein und prüft es. Anschließend werden die Quell- und Zielarbeitsdateien für dieses Textprotokoll erstellt und gefüllt. Wählt der Benutzer die selbe Datei, die die Protokolldatei zur Zeit geladen hat, fragt die Methode den Benutzer, ob das Protokoll neu geladen und analysiert werden soll. Damit wird sichergestellt, dass das Protokoll nicht in einem Textfenster geöffnet ist, bevor es geladen wird. Gibt der Benutzer lMarkAllOnLoad an, werden alle Datensätze im aktuellen Modus markiert (Erfassungsprotokoll- oder Profile-Modus), nachdem die Zieldatei erfolgreich mit Quellcodeeinträgen gefüllt wurde. Wird der Erfassungsprotokoll-Profiler im unbeaufsichtigten Modus ausgeführt, werden alle Datensätze sowohl im Erfassungsprotokoll- als auch im Profile-Modus markiert, nachdem die Zieldatei erfolgreich gefüllt wurde. Verläuft das Laden erfolgreich, stellt diese Methode außerdem den cStandardWritePath ein, um den Pfad des Textprotokolls und der cSourceFile-Eigenschaft, in der der Name dieses Textprotokolls gespeichert ist, zu markieren.
SetWorkOptions( )-Methode
Legt die ursprünglichen benutzerdefinierten Optionen fest.
SetWorkOptions( )
Rückgabewerte
NOT THIS.lError
Parameter
Keine (None)
Hinweise
Die SetWorkOptions( )-Methode richtet die ursprünglichen Optionen gemäß den Benutzer- oder Standardeinstellungen ein, bevor die Arbeitsdateien erzeugt werden. Diese Optionsgruppe beinhaltet Markierungen des Erfassungsprotokolls sowie den Ausgangsmodus des Erfassungsprotokolls und wird für die Verarbeitung der Arbeitsdateien benötigt.
ShowProjectStatistics( )-Methode
Führt Analysezahlen eines Erfassungsprotokolls für ein Visual FoxPro-Projekt aus.
ShowStatistics(tcSource, tcTarget, tcProject)
Rückgabewerte
lReturn und NOT THIS.lError
Parameter
- tcSource
Gibt den Namen der Tabelle an, die die Quelldatensätze enthält. - tcTarget
Gibt den Namen der Tabelle an, die gerade geändert wird. - tcProject
Gibt das Projekt an, das tcSource enthält.
Hinweise
Die ShowProjectStatistics( )-Methode ruft GetProjectStatistics( ) und DisplayProjectStatistics( ) auf, um Erfassungsprotokoll-Analysewerte auf einen bestimmten Projektdateisatz von Visual FoxPro anzuwenden.
ShowStatistics( )-Methode
Liegt in abstrakter Form im Basismodul vor.
ShowStatistics( )
Rückgabewerte
NOT THIS.lError
Parameter
Keine (None)
ShowStatus( )-Methode
Platziert eine Meldung in die Statusleiste oder in ein Wartefenster (WAIT WINDOW). Weitere Informationen finden Sie im Abschnitt zur IUsingStatusBar-Eigenschaft.
ShowStatus(cMessage)
Parameter
- cMessage
Gibt die Meldung an, die in der Statusleiste oder im Wartefenster angezeigt werden soll.
SourceAvailable( )-Methode
Ersetzt den kompilierten Dateinamen des aktuellen Quellprotokolls durch den vollständigen Pfadnamen der Datei, die den unkompilierten Quellcode enthält.
SourceAvailable( )
Rückgabewerte
lReturn
Parameter
Keine (None)
Hinweise
Sofern erforderlich, ruft die SourceAvailable( )-Methode die GetSourceLoc( )-Methode auf, um nicht kompilierten Quellcode zu suchen. Ist die lSmarthPath-Eigenschaft wahr (.T.), wird AddPath( ) verwendet, um SET (PATH) anzupassen, wenn der Benutzer Verzeichnisse angegeben hat, in denen die Quelldateien zu finden sind. Es wird falsch (.F.) zurückgegeben, wenn die Quelldatei auf der Liste der zu ignorierenden Dateien steht, der Typ der Datei unbekannt ist oder der unkompilierte Quellcode nicht gefunden werden kann.
SourceFileIsLog( )-Methode
Überprüft, ob der Dateiname, der in der cSourceFile-Eigenschaft gespeichert ist, ein gültiges Erfassungsprotokollformat besitzt.
SourceFileIsLog( )
Rückgabewerte
lReturn
Parameter
Keine (None)
SuspendCoverage( )-Methode
Legt für die cSuspendedLog-Eigenschaft den Namen des aktuellen Protokolls fest.
SuspendCoverage( )
Rückgabewerte
Keine (None)
Parameter
Keine (None)
Hinweise
Legt für cSuspendedLog den Namen des aktuellen Protokolls fest und bewirkt, dass Visual FoxPro vorübergehend nicht in dieses Protokoll schreiben kann, sofern einer der folgenden Fälle eintritt:
- Der übergebene Dateiname entspricht dem des aktuellen Erfassungsprotokolls.
- Es wurde kein Dateiname übergeben, so dass das Modul das aktuelle Erfassungsprotokoll standardmäßig analysiert.
ToggleCoverageProfileMode( )-Methode
Markiert alle Zieldatensätze im neuen Modus.
ToggleCoverageProfileMode(tcSource, tcTarget)
Rückgabewerte
RETURN NOT THIS.lError
Parameter
- tcSource
Gibt den Namen der Tabelle an, die die Quelldatensätze enthält. - tcTarget
Gibt den Namen der Tabelle an, die gerade geändert wird.
Hinweise
Ist die lMarkAllOnLoad-Eigenschaft wahr (.T.), werden alle Zieldatensätze im neuen Modus markiert.
cSavedStackXML-Eigenschaft
Speichert den Namen der gespeicherten Erfassungsprotokoll-Analyse (Stacklevel) im XML-Format, nachdem diese Datei auf Festplatte gespeichert wurde. Wird ein neues Protokoll geladen, wird diese Eigenschaft auf die Standardeinstellung ("") zurückgesetzt.
lStackXMLExtendedTree-Eigenschaft
Ist diese Eigenschaft wahr (.T.), werden größere StackXML-Dateien generiert, so dass beim Profilieren der einzelnen Verzweigungen die Auswirkungen von Argumenten und anderen Faktoren für unterschiedliche Aufrufe eines Moduls berücksichtigt werden können. Die Standardeinstellung ist falsch (.F.), wenn jedoch für COV_LOAD_STACK_FROM_DBF wahr (.T.) festgelegt ist, dann wird immer die große XML-Datei generiert.
ShowStackXML( )
ShowStackXML(tclog)
Rückgabetypen
Logisch Wahr (.T.), falls erfolgreich.
Parameter
- tcLog
Gibt den Namen der Protokolldatei an.
Hinweise
ShowStackXML( ) ruft GetStackXML(tcLog) und DisplayStackXML(tcXMLFile) auf, um Erfassungsprotokoll-Analysewerte auf einen bestimmten Projektdateisatz von Visual FoxPro anzuwenden. Das Argument tcLog wird ignoriert, wenn für DEFINEd COV_LOAD_STACK_FROM_DBF wahr (.T.) festgelegt ist.
GetStackXML( )-Methode
Geniert die XML-Datei der Stack-Analyse aus tcLog.
GetStackXML(tclog)
Rückgabetypen
Logisch Wahr (.T.), falls erfolgreich.
Parameter
- tcLog
Gibt den Namen der Protokolldatei an.
Hinweise
Die Standardeinstellung für diese Funktion ist das aktuelle Erfassungsquellprotokoll. Das Argument tcLog wird ignoriert, wenn für DEFINEd COV_LOAD_STACK_FROM_DBF wahr (.T.) festgelegt ist.
DisplayStackXML( )-Methode
Zeigt die XML-Datei an.
DisplayStackXML(tcXMLFile)
Rückgabetypen
Logisch Wahr (.T.), wenn kein Fehler auftritt.
Die Standardeinstellung ist der Dateiname der aktuellen Stack-Analyse, der in der cSavedStackXML-Eigenschaft angegeben wird.
Hinweise
Diese Methode ähnelt DisplayProjectStatistics*,* mit dem Unterschied, dass diese Methode im Modul nicht abstrakt vorliegt, sondern dass cov_engine.DisplayStackXMLeinShellExecuteA durchführt.
ToggleStackXMLExtendedTree( )-Methode
Schaltet **.lStackXMLExtendedTree um.
ToggleStackXMLExtendedTree( )
Rückgabetypen
Logisch Wahr (.T.), wenn kein Fehler auftritt.
Parameter
Keine (None)
Hinweise
Diese Methode wurde für folgende Zwecke entwickelt: um in Unterklassen erweitert zu werden, um diesen Schalter in der Benutzeroberfläche zu reflektieren, um den Standardwert für XSLT auf dieser Basis zu ändern usw. Diese Methode ähnelt ToggleCoverageProfileMode.
*.cStackXSLT-Eigenschaft
Enthält den Namen der Datei, die das Standardstylesheet für die XSL-Transformation enthält, das standardmäßig für das XML-Stack-Analysedokument angewendet wird, wenn TransformStackXML aufgerufen wird.
*.TransformStackXML( )-Methode
TransformStackXML(tcXSLT, tcXMLIn, tcXMLOut, tlNoShow)
Rückgabetypen
Gibt Wahr (.T.) zurück, falls erfolgreich.
Parameter
- tcXSLT
Gibt den Namen der XSL-Datei an. - tcXMLIn
Gibt den Namen der XML-Eingabedatei an. - tcXMLOut
Gibt den Namen der XML-Ausgabedatei an. - tlNoShow
Gibt an, ob DisplayStackXML aufgerufen werden soll.
Hinweise
Wendet tcXSLT (Standard für **.cStackXSLT) für tcXMLIn (Standard für .cSavedStackXML, GetStackXML( ) wird aufgerufen, falls leer) an. Speichert das Ergebnis in tcXMLOut(Standard für den auf Basis von tcXMLIn generierten Namen mti der Erweiterung HTM). Wenn ! tlNoShow, dann wird DisplayStackXML( ) aufgerufen.