Lade...
 

CX_FILE_SOURCE_RANGE

CX_FILE_SOURCE_RANGE

230011
Klassenhierarchie
Beschreibung:

Objekte dieser Klasse repräsentieren einen Bereich in einer Quelldatei und bieten Methoden an, um den referenzierten Code zu lesen, überschreiben oder im Editor zu öffnen.

Der Bereich ist definiert über den absoluten Pfad zur Quelldatei, sowie eine Start- und Endposition. Sowohl Start- als auch Endposition sind definiert als (Zeile:Spalte), wobei beide Angaben bei 0 beginnen. Das erste Zeichen einer Datei hat somit die Position (0:0).

Wichtig: Die End-Position definiert die Position des ersten Zeichens, welches nicht mehr zu dem selektierten Quellcodebereich gehört. 

Diese Art der Definition ermöglicht es unter anderem eine bestimmte Zeile aus einer Datei zu selektieren, ohne wissen zu müssen, wie viele Zeichen diese Zeile überhaupt enthält (da die Position des letzten Zeichens hierfür nicht benötigt wird).

Um die 7. Zeile einer Datei zu selektieren, wäre die Range wie folgt definiert: (start=(6:0), end=(7:0))

Code-Beispiel:

Var(sourceRange)
CreateTransObject(CX_FILE_SOURCE_RANGE) -> sourceRange
"evaluate.cxp" sourceRange Put(File())
FALSE sourceRange Call(Read) // ".... whole file content..."

// now only read the 7th line
6 sourceRange Put(StartLine())
0 sourceRange Put(StartColumn())
7 sourceRange Put(EndLine())
0 sourceRange Put(EndColumn())
FALSE sourceRange Call(Read) // "... 7th line content ... "

Methodenverzeichnis (MDI)
Funktion MA* Parameter Rückgabe Kurzbeschreibung
EditSource       Öffnet die Start-Position dieser Source-Range im Quellcode-Editor
EndColumn *   INTEGER Spalte der End-Position (bei 0 beginnend)
EndLine *   INTEGER Zeile der End-Position (bei 0 beginnend)
File *   STRING Lese-/Schreibzugriff auf den Dateinamen/-pfad für diese Source-Range
IsValid     INTEGER Ist dies eine gültige Source-Range-Definition?
IsValidRange
230223
    INTEGER Sind Start- & Endposition gültig?
Read   INTEGER STRING Liest den definierten Bereich aus der Quelldatei
ReadFromString
230177
  STRING STRING Liest den definierten Bereich aus dem übergebenen STRING
RelativeTo
230177
  CX_FILE_SOURE_RANGE CX_FILE_SOURCE_RANGE Berechnet einen neuen Quellcodebereich relativ zur Startposition des übergebenen Quellcodebereichs.
Rewrite   STRING   Überschreibt den definierten Bereich in der Quelldatei
RewriteInString
230177
  STRING, STRING STRING Ersetzt den definierten Bereich im übergebenen Quellstring durch den Ersetzungsstring.
StartColumn *   INTEGER Start-Spalte der Source-Range (bei 0 beginnend)
StartLine *   INTEGER Start-Zeile der Source-Range (bei 0 beginnend)

* MA = Member-Access-Funktion,
grau unterlegt = geerbte Funktion

 

Datenverzeichnis (DDI)
Datenfeld Typ Referenz-Klasse I* Kurzbeschreibung
         

* I = Indizierbares Datenfeld,
grau unterlegt = geerbtes Datenfeld

 

Verwendung in AppsWH
Modul Kurzbeschreibung