Hahn: CAD-XML-Syntax-Dokumentation (automatischer Import)

2026-07-20T12:50:34Z

CAD-XML-Syntax-Dokumentation (automatischer Import)

Neue Seite

{{DISPLAYTITLE:CAD XML Syntax-Objekt VC_CADVCPNRText und Varianten}}
Punktnummerntexte sind spezialisierte Textobjekte, die die Punktnummer (bzw. Punktparameter) eines referenzierten [[CAD XML Syntax-Objekt VC CADPunkt|VC_CADPunkt]] darstellen. Basisklasse ist <code>T2DVCPNRText</code> (<code>CAD\GLGeometrics.pas</code>), Wurzeltag <code>VC_CADVCPNRText</code>; daneben existieren sechs Parameter-Varianten-Tags für VMA-Kürzel-, InGerade- und AufKreisbogen-Texte (je „normal“ und „Original“). Alle erben die komplette Serialisierung von [[CAD XML Syntax-Objekt VC CADText|VC_CADText]] — auch hier steht der Textinhalt im inneren Element <code><VC_CADText>…</VC_CADText></code>.

== Tag-Übersicht (Tag → Klasse → Verfügbarkeit) ==
{| class="wikitable"
! XML-Wurzeltag !! Delphi-Klasse !! IsOriginal !! Verfügbarkeit (Code/IFDEF)
|-
| <code>VC_CADVCPNRText</code> || <code>T2DVCPNRText</code> || — || alle Bundesländer
|-
| <code>VC_CADVCPNRParVMAKuerzelText</code> || <code>T2DVCPNRParameterVMAKuerzelText</code> || False || alle Bundesländer
|-
| <code>VC_CADVCPNRParVMAKuerzelOriginalText</code> || <code>T2DVCPNRParameterVMAKuerzelText</code> || True || alle Bundesländer
|-
| <code>VC_CADVCPNRParInGeradeText</code> || <code>T2DVCPNRParameterInGeradeText</code> || False || nur BW (<code>{$IFDEF BW}</code>)
|-
| <code>VC_CADVCPNRParInGeradeOriginalText</code> || <code>T2DVCPNRParameterInGeradeText</code> || True || nur BW
|-
| <code>VC_CADVCPNRParAufKreisbogenText</code> || <code>T2DVCPNRParameterAufKreisbogenText</code> || False || nur BW
|-
| <code>VC_CADVCPNRParAufKreisbogenOriginalText</code> || <code>T2DVCPNRParameterAufKreisbogenText</code> || True || nur BW
|}

'''Wichtig:''' Die „Original“-Varianten sind KEINE eigenen Klassen, sondern dieselbe Klasse mit gesetztem Flag <code>IsOriginal=True</code>. Die Factory-Funktionen der Original-Tags setzen beim Lesen das Flag; beim Schreiben wählt der Manager anhand von <code>IsOriginal</code> den Original- oder Normal-Tag (<code>GLGeometrics.pas:79993-80026</code>). Die Variante steckt also '''allein im Wurzeltag''', nicht in einem XML-Element.

Klassenhierarchie: <code>T2DText</code> → <code>T2DVCPNRTextBase</code> → <code>T2DVCPNRText</code> (Punktnummerntext) bzw. <code>T2DVCPNRTextBase</code> → <code>T2DVCPNRParameterText</code> → die drei Parameter-Klassen. In Nicht-BW-Versionen sind die InGerade-/AufKreisbogen-Tags nicht registriert — solche Elemente würden dort als unbekannte Objekt-Tags komplett ignoriert.

== Strukturregel ==
<pre>
<VC_CADVCPNRText> (bzw. einer der 6 Varianten-Tags)
<VermCadID> … </VermCadID> (siehe VermCadID-Block; CADObjektArt = cadText,
ObjektArt typisch oaVC)
[Basiselemente] (siehe Basiselemente; Layer ist Pflicht)
[alle Text-Elemente von VC_CADText] (siehe Objektseite VC_CADText;
Textinhalt im inneren <VC_CADText>-Element)
<Text_RissDaten> … </Text_RissDaten>
[<PktNrText_SpecialOutputText>text</PktNrText_SpecialOutputText>] (NUR VC_CADVCPNRText; mehrzeilig möglich)
[<IsAdditionalVCPNRText>bool</IsAdditionalVCPNRText>] (NUR VC_CADVCPNRText)
</VC_CADVCPNRText>
</pre>

== Elemente ==
Nur die eigenen Elemente gegenüber [[CAD XML Syntax-Objekt VC CADText|VC_CADText]]. Die beiden Zusatzelemente gehören zur Klasse <code>T2DVCPNRText</code> — die '''Parameter-Varianten haben KEINE eigenen XML-Elemente''' (sie erben von <code>T2DVCPNRTextBase</code>, nicht von <code>T2DVCPNRText</code>, und serialisieren exakt wie ein VC_CADText).

{| class="wikitable"
! Element !! Typ/Format !! Pflicht !! Default !! Bedeutung
|-
| <code>PktNrText_SpecialOutputText</code> || text — '''mehrzeiliger Textknoten möglich''' (Zeilenumbrüche stehen roh im Element) || nein || '''' || Sondertext, der statt der Punktnummer ausgegeben wird (bei <code>PktNrTextType=TT_SPECIAL</code> am Referenzpunkt); nur geschrieben, wenn der Textinhalt und der Sondertext nicht leer sind
|-
| <code>IsAdditionalVCPNRText</code> || bool (-1/0) || nein || False || Kennzeichnung als zusätzlicher (zweiter) Punktnummerntext eines Punkts; nur geschrieben, wenn True
|}

Besonderheiten des Textinhalts:
* Default-Textinhalt neuer PNR-Texte ist der Platzhalter <code>#TEXTVONTEXTSTIL</code> (<code>PROPERTY_TEXT_FROMTEXTSTIL</code>; seit 06/2025 — vorher <code>$PNR$</code>). In den Bestandsdaten ist <code><VC_CADText>#TEXTVONTEXTSTIL</VC_CADText></code> der Regelfall.
* Der Platzhalter <code>$PNR$</code> (<code>TEXT_PLACEHOLDER_PUNKTNUMMER</code>) wird bei der Darstellung durch die Punktnummer (bzw. NV+NR oder den SpecialOutputText) des Referenzpunkts ersetzt — er kann auch in Kombination stehen (z. B. <code>Meine NR: $PNR$</code>).
* Welche Nummer dargestellt wird, steuert <code>PktNrTextType</code> '''am referenzierten Punkt''' (bzw. rissabhängig dessen <code>RissPktNrTextType</code>), nicht am Text.

== Referenzen ==
Wie bei [[CAD XML Syntax-Objekt VC CADText|VC_CADText]]: <code>Text_Referenzobjekt</code> zeigt auf den zugehörigen VC_CADPunkt und ist praktisch Pflicht (ohne Referenzpunkt kann kein Punktnummern-/Parametertext dargestellt werden; fehlt das Ziel endgültig, wird der Text beim Referenzen-Update zerstört).

== Minimalform ==
<pre>
<VC_CADVCPNRText>
<VermCadID>
<GUID>{XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX}</GUID>
<ObjektArt>oaVC</ObjektArt>
<CADObjektArt>cadText</CADObjektArt>
</VermCadID>
<Layer>-235</Layer>
<Text_Referenzobjekt GUID="{XXXX…}" />
<VC_CADText>#TEXTVONTEXTSTIL</VC_CADText>
<Text_RissDaten />
</VC_CADVCPNRText>
</pre>
Für die Varianten denselben Aufbau mit dem jeweiligen Wurzeltag verwenden.

== Beispiele ==
=== Beispiel (Baden-Württemberg) — Standardform (alle BW-Exemplare identisch aufgebaut) ===
<pre>
<VC_CADVCPNRText>
<VermCadID>
<GUID>{E09395D3-…}</GUID>
<ObjektArt>oaVC</ObjektArt>
<CADObjektArt>cadText</CADObjektArt>
</VermCadID>
<Layer>-235</Layer>
<LayerErben>-1</LayerErben>
<Text_Referenzobjekt GUID="{1CB09C10-…}" />
<VC_CADText>#TEXTVONTEXTSTIL</VC_CADText>
<Text_RissDaten />
</VC_CADVCPNRText>
</pre>

=== Beispiel (Sachsen) — RefPkt-Verschiebung, gefüllte Text_RissDaten und mehrzeiliger SpecialOutputText ===
<pre>
<VC_CADVCPNRText>
<VermCadID>
<GUID>{E8AFB7D5-…}</GUID>
<ObjektArt>oaVC</ObjektArt>
<CADObjektArt>cadText</CADObjektArt>
</VermCadID>
<Layer>787</Layer>
<LayerErben>-1</LayerErben>
<Text_Referenzobjekt GUID="{798B27AC-…}" />
<Text_RefPktMoveX>-6.79097226588056</Text_RefPktMoveX>
<Text_RefPktMoveY>2.55763887800276</Text_RefPktMoveY>
<VC_CADText>#TEXTVONTEXTSTIL</VC_CADText>
<Text_RissDaten>
<RissEintrag_0>
<Text_RissRefPktMove>-6.13705911999569 2.45703685283661 0</Text_RissRefPktMove>
</RissEintrag_0>
<RissEintrag_1>
<Text_RissRefPktMove>-6.13705911999569 2.45703685283661 0</Text_RissRefPktMove>
</RissEintrag_1>
</Text_RissDaten>
<PktNrText_SpecialOutputText>189
DES:[1800]
GST:[2100]
ENT:[4267R0702]</PktNrText_SpecialOutputText>
</VC_CADVCPNRText>
</pre>
Der Wert von <code>PktNrText_SpecialOutputText</code> ist hier ein '''mehrzeiliger Textknoten''' — die Zeilenumbrüche gehören zum Wert. Details zu <code>Text_RissDaten</code>: [[CAD XML Syntax-Rissdaten an Objekten|Rissdaten an Objekten]].

=== Beispiel (Baden-Württemberg) — Parameter-Variante InGerade ===
<pre>
<VC_CADVCPNRParInGeradeText>
<VermCadID>
<GUID>{1BAA940B-…}</GUID>
<ObjektArt>oaVC</ObjektArt>
<CADObjektArt>cadText</CADObjektArt>
</VermCadID>
<Layer>-1007</Layer>
<Text_Referenzobjekt GUID="{37EE340E-…}" />
<VC_CADText>#TEXTVONTEXTSTIL</VC_CADText>
<Text_RissDaten />
</VC_CADVCPNRParInGeradeText>
</pre>
<code>VC_CADVCPNRParVMAKuerzelText</code> (Layer −1006) und <code>VC_CADVCPNRParVMAKuerzelOriginalText</code> (Layer −1009) sind in den Bestandsdaten strukturell identisch aufgebaut — nur der Wurzeltag (und der System-Layer) unterscheidet sich.

=== Konstruiertes Beispiel — AufKreisbogen-Original-Variante (nur BW; kein Bestandsbeispiel vorhanden) ===
<pre>
<VC_CADVCPNRParAufKreisbogenOriginalText>
<VermCadID>
<GUID>{XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX}</GUID>
<ObjektArt>oaVC</ObjektArt>
<CADObjektArt>cadText</CADObjektArt>
</VermCadID>
<Layer>-1010</Layer>
<Text_Referenzobjekt GUID="{XXXX…}" />
<VC_CADText>#TEXTVONTEXTSTIL</VC_CADText>
<Text_RissDaten />
</VC_CADVCPNRParAufKreisbogenOriginalText>
</pre>
(Nach den Regeln konstruiert — in den drei untersuchten Beispielprojekten kommen die AufKreisbogen-Tags nicht vor; Layer-ID beispielhaft.)

== Verfügbarkeit und Besonderheiten ==
* '''Code-Verfügbarkeit''': <code>VC_CADVCPNRText</code> und beide VMAKuerzel-Tags in allen Bundesland-Versionen; die vier InGerade-/AufKreisbogen-Tags nur in BW (<code>{$IFDEF BW}</code> in Factory und Klassendeklaration).
* '''Belege aus den Beispielprojekten''' (getrennt von der Code-Verfügbarkeit): <code>VC_CADVCPNRText</code> in BW/Sachsen/THR belegt; <code>VC_CADVCPNRParInGeradeText</code> (254×) und <code>VC_CADVCPNRParVMAKuerzelText</code> (219×) nur in BW belegt; <code>VC_CADVCPNRParVMAKuerzelOriginalText</code> in BW (1×) und Sachsen (86×); die beiden AufKreisbogen-Tags und die InGerade-Original-Variante sind in keinem der drei Projekte belegt.
* '''Speicher-Weiche''': Beim Speichern entscheidet der Klassentyp plus <code>IsOriginal</code> über den Wurzeltag; beim Lesen setzt der Factory-Eintrag des Original-Tags <code>IsOriginal:=True</code>.
* PNR-Texte entstehen normalerweise automatisch (ObjektArt <code>oaVC</code>) und liegen auf System-Layern (negativ, z. B. −235, −1006, −1007, −1009) oder erben den Layer des Punkts (<code>LayerErben</code>).
* Es gelten alle Besonderheiten von [[CAD XML Syntax-Objekt VC CADText|VC_CADText]] (doppelter Tag <code>VC_CADText</code> als Inhaltselement, leere Texte werden nicht gespeichert, Legacy-Aliase).

== Quellen im Code ==
* <code>CAD\GLGeometrics.pas:55198-55233</code> — <code>T2DVCPNRText.DataToXMLLite</code> (SpecialOutputText, IsAdditionalVCPNRText)
* <code>CAD\GLGeometrics.pas:55161-55185</code> — <code>T2DVCPNRText.InternalCreateFromXML</code>
* <code>CAD\GLGeometrics.pas:55139-55150</code> — <code>AfterConstruction</code> (Default-Text <code>PROPERTY_TEXT_FROMTEXTSTIL</code>)
* <code>CAD\GLGeometrics.pas:2989-3081</code> — Klassendeklarationen <code>T2DVCPNRTextBase</code>, <code>T2DVCPNRText</code>, <code>T2DVCPNRParameterText</code> (+ Varianten, BW-IFDEF)
* <code>CAD\GLGeometrics.pas:83800-83832</code> — Factory-Funktionen (Original-Varianten setzen <code>IsOriginal:=True</code>)
* <code>CAD\GLGeometrics.pas:97023-97031</code> — Factory-Registrierung der 7 Tags (BW-IFDEF)
* <code>CAD\GLGeometrics.pas:79982-80026</code> — Speicher-Weiche Tag je Klasse/IsOriginal; leere Texte werden nicht gespeichert
* <code>CAD\GLConsts.pas:245, 458</code> — <code>TEXT_PLACEHOLDER_PUNKTNUMMER</code> (<code>$PNR$</code>), <code>PROPERTY_TEXT_FROMTEXTSTIL</code> (<code>#TEXTVONTEXTSTIL</code>)
* <code>VERMCAD\GlobalConsts.pas</code> ca. 4372-5004 — Tag-Konstanten (<code>xn_CADVCPNRText</code>, <code>xn_CADVCPNRParameter*</code>, <code>xn_SpecialOutputText</code>, <code>xn_IsAdditionalVCPNRText</code>)

{{Hilfe:NachOben}}
[[Kategorie:CAD XML Syntax]]

CAD XML Syntax-Objekt VC CADVCPNRText und Varianten - Versionsgeschichte

Hahn: CAD-XML-Syntax-Dokumentation (automatischer Import)