CX_FILE_SOURCE_RANGE
Klassenhierarchie
- CX_CLASS
- CX_FILE_SOURCE_RANGE
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 ... "
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
Datenfeld | Typ | Referenz-Klasse | I* | Kurzbeschreibung |
---|---|---|---|---|
* I = Indizierbares Datenfeld,
grau unterlegt = geerbtes Datenfeld
Modul | Kurzbeschreibung |
---|---|