Suche in: Doc:Dokumentation: Altium Designer
Altium DesignerAltium 365Altium MCAD CoDesignerAltium On-Prem Enterprise ServerAltium CircuitMakerAltium CircuitStudioCompany DashboardAltium Infrastructure ServerAltium Developer Center
Product Schließen
Suche Suche in der Dokumentation

Arbeiten mit Textobjekten

Updated: October 05, 2026

Auf einen Blick

Dieser Artikel zeigt Ihnen, wie Sie Textobjekte in Altium Designer sowohl in PCB-Dokumenten als auch in PCB-Footprints platzieren, formatieren und bearbeiten. Dazu gehören einzeilige Zeichenfolgen, mehrzeilige Textrahmen sowie Optionen wie Barcodes und QR-Codes. Außerdem erfahren Sie, wie spezielle Zeichenfolgen funktionieren, woher ihre Werte stammen, wie sie angezeigt werden und wie Sie damit Informationen zur Leiterplatte, zum Projekt, zum System und zu Parametern direkt auf der Leiterplatte oder in generierten Ausgaben darstellen können. Sie suchen eine praktische Anleitung, um Text auf Ihrer Leiterplatte und in Ihrer Dokumentation effektiver einzusetzen? Lesen Sie weiter – dieser Artikel hilft Ihnen, diese Funktionen sicher zu nutzen.

- Erfahren Sie, wie Sie Textobjekte platzieren und bearbeiten, zwischen den Modi „Zeichenfolge“ und „Rahmen“ wechseln und Tastenkombinationen zum Drehen, Spiegeln, Wechseln der Leiterplattenseite und Ändern der Lage verwenden.
- Lernen Sie, was spezielle Zeichenfolgen sind, wie Sie sie hinzufügen und wie sich damit Informationen zu Leiterplatten, Projekten, Varianten, Bauteilen und dem System anzeigen lassen.
- Entdecken Sie, wie Textobjekte mit Textrahmen mit Zeilenumbruch sowie Barcode- und QR-Code-Unterstützung die Anforderungen an Dokumentation und Fertigung erfüllen können.
Mit KI tiefer einsteigen:

Ein Textobjekt platziert eine einzeilige Zeichenfolge oder einen mehrzeiligen Textrahmen auf der ausgewählten Lage. Dabei stehen verschiedene Darstellungsstile und Formate zur Verfügung, darunter gängige Barcode-Standards und QR-Codes. Es kann sich um benutzerdefinierten Text oder eine besondere Art von Zeichenfolge handeln, die als Sonderzeichenfolge bezeichnet wird und zur Anzeige von Leiterplatten- oder Systeminformationen oder der Werte von Benutzerparametern auf der Leiterplatte verwendet werden kann. Der Textrahmen ist ein rechteckiger Bereich mit veränderbarer Größe, der mehrere Textzeilen enthalten kann. Text kann automatisch umgebrochen und abgeschnitten werden, damit er innerhalb der Rahmengrenzen bleibt.

Platzierte Textobjekte
Platzierte Textobjekte

Textobjekte können sowohl im PCB-Editor als auch im PCB-Footprint-Editor über den Befehl Place » String oder Place » Text Frame in den Hauptmenüs platziert werden. Nach dem Aufrufen des Befehls zur Textplatzierung wird der Cursor zu einem Fadenkreuz, und Sie gelangen in den Textplatzierungsmodus. Ein Textobjekt erscheint am Cursor:

  1. Positionieren Sie den Cursor und klicken Sie oder drücken Sie Enter, um ein Textobjekt zu platzieren.
  2. Platzieren Sie weitere Textobjekte oder klicken Sie mit der rechten Maustaste bzw. drücken Sie Esc, um den Platzierungsmodus zu beenden.
Je nach ausgewähltem Platzierungsbefehl (Place » String oder Place » Text Frame) befindet sich das zu platzierende Textobjekt im Modus String oder Frame. Dieser kann während oder nach der Platzierung im Properties-Panel geändert werden.

Während der Platzierung sind folgende zusätzliche Aktionen möglich:

  • Drücken Sie Spacebar, um das Textobjekt gegen den Uhrzeigersinn zu drehen, oder Shift+Spacebar, um es im Uhrzeigersinn zu drehen. Die Drehung erfolgt entsprechend dem Wert für Rotation Step, der auf der Seite  PCB Editor – General des Dialogs Preferences festgelegt ist.
  • Drücken Sie die Taste X oder Y, um das Textobjekt entlang der X- bzw. Y-Achse zu spiegeln.
  • Drücken Sie die Taste L, um das Textobjekt auf die andere Seite der Leiterplatte zu verschieben.
  • Drücken Sie die Tasten + und - (auf dem Ziffernblock), um vorwärts bzw. rückwärts durch alle sichtbaren Lagen des Designs zu wechseln und so die Platzierungslage schnell zu ändern.

Bei der grafischen Bearbeitung können Sie ein platziertes Textobjekt direkt im Designbereich auswählen und seine Position, Drehung, Ausrichtung und Größe ändern.

Wenn ein Textobjekt ausgewählt ist, stehen die folgenden Bearbeitungsgriffe zur Verfügung:

Ein ausgewähltes Textobjekt
Ein ausgewähltes Textobjekt

  • Klicken Sie auf B und ziehen Sie, um das Textobjekt um seinen Referenzpunkt A (durch das kleine x gekennzeichnet) zu drehen.
  • Klicken Sie auf C und ziehen Sie, um die Größe des Begrenzungsrahmens des Textobjekts gleichzeitig in vertikaler und horizontaler Richtung zu ändern.
  • Klicken Sie auf D und ziehen Sie, um die Größe des Begrenzungsrahmens des Textobjekts in vertikaler und horizontaler Richtung getrennt zu ändern.
  • Klicken Sie auf eine beliebige Stelle des Textobjekts außerhalb der Bearbeitungsgriffe und ziehen Sie, um es neu zu positionieren. Während des Ziehens kann der Kommentar gedreht oder gespiegelt werden:
    • Drücken Sie Spacebar, um das Textobjekt gegen den Uhrzeigersinn zu drehen, oder Shift+Spacebar, um es im Uhrzeigersinn zu drehen. Die Drehung erfolgt entsprechend dem Wert für Rotation Step, der auf der Seite PCB Editor – General des Dialogs Preferences festgelegt ist.
    • Drücken Sie die Taste X oder Y, um das Textobjekt entlang der X- bzw. Y-Achse zu spiegeln.
  • Der Standardtext für ein neu platziertes Zeichenfolgenobjekt lautet String. Ändern Sie diesen Text nach der Platzierung nach Bedarf im Texteingabefenster, das beim Anzeigen der Eigenschaften der Zeichenfolge im Properties-Panel verfügbar ist, sofern der Text nicht bereits vor oder während der Platzierung geändert wurde.
  • Die Software bietet die Möglichkeit, Textobjekte als Barcode-Symbole direkt auf einer beliebigen Lage einer Leiterplatte zu platzieren. Dadurch lassen sich Barcodes im Rahmen des Fertigungsprozesses einfach auf eine Leiterplatte aufbringen. Weitere Informationen zur Verwendung eines Textobjekts als Barcode finden Sie im Abschnitt Hinzufügen eines Barcodes auf der Seite Einbinden von Barcodes & Logos.
  • Die Software bietet die Möglichkeit, Textobjekte als QR-Codes direkt auf einer beliebigen Lage einer Leiterplatte zu platzieren. Dadurch lassen sich QR-Codes im Rahmen des Fertigungsprozesses einfach auf eine Leiterplatte drucken. Weitere Informationen zur Verwendung eines Textobjekts als QR-Code finden Sie im Abschnitt Hinzufügen eines QR-Codes auf der Seite Einbinden von Barcodes & Logos.

Sonderzeichenfolgen

Mit Textobjekten lässt sich benutzerdefinierter Text auf der aktuellen PCB-Lage platzieren, es kann jedoch nicht only benutzerdefinierter Text platziert werden. Zur Unterstützung bei der Erstellung der Dokumentation wird das Konzept der special strings verwendet. Diese dienen als Platzhalter für Design-, System- oder Projektinformationen, die bei der Ausgabeerzeugung auf der Leiterplatte angezeigt werden sollen.

Beispiele für Sonderzeichenfolgen für Design- und Systeminformationen sowie Designparameter, dargestellt als ursprüngliche Zeichenfolgen (erstes Bild) und in umgewandelter Form (zweites Bild). 
Beispiele für Sonderzeichenfolgen für Design- und Systeminformationen sowie Designparameter, dargestellt als ursprüngliche Zeichenfolgen (erstes Bild) und in umgewandelter Form (zweites Bild).

Die in einem PCB-Dokument verfügbaren Sonderzeichenfolgen stammen aus verschiedenen Quellen:

  • Für neue PCB-Dokumente steht ein Standardsatz vordefinierter Sonderzeichenfolgen zur Verfügung.
  • Benutzerdefinierte Sonderzeichenfolgen können durch die Definition zusätzlicher Parameter auf Projektebene (auf der Registerkarte Parameters des Dialogs Project Options) und auf Variantenebene (im Dialog Edit Project Variant oder im Properties-Panel im Modus Variant im Variant Manager) hinzugefügt werden.
  • Benutzerparameter, die Bauteilen im Schaltplan hinzugefügt werden, werden über einen ECO übertragen und stehen anschließend den PCB-Bauteilen zur Verfügung. Wird einem PCB-Footprint bereits in der Quellbibliothek eine Sonderzeichenfolge hinzugefügt, die auf einen Bauteilparameter verweist, wird diese Zeichenfolge beim Platzieren des PCB-Bauteils auf der mechanischen Ziellage oder der Bestückungsdrucklage ausgewertet.

Hinweise zur Verwendung von Sonderzeichenfolgen

  • Eine Sonderzeichenfolge ist dadurch gekennzeichnet, dass sie mit einem Punkt (.) beginnt (z. B. .Layer_Name, .Net_Count usw.).  Wenn eine Zeichenfolge mit „.“ beginnt, wird die gesamte Zeichenfolge als Sonderzeichenfolge behandelt. Diese Syntax wird auch beim Verweisen auf einen Benutzerparameter verwendet: Dem Parameternamen wird ein Punkt (.) vorangestellt.
  • Um mehrere Sonderzeichenfolgen in einen PCB-Text einzubinden, schließen Sie jede Sonderzeichenfolge in Apostrophe ( ' ) ein, zum Beispiel: '.Pcb_File_Name_No_Path' '.Print_Date'.
  • Sie können zwischen verketteten Sonderzeichenfolgen auch Text, Leerzeichen und Sonderzeichen verwenden, zum Beispiel: FileName= '.Pcb_File_Name_No_Path' : PrintDate = '.Print_Date'.
  • Leerzeichen und Sonderzeichen können auch in den Namen von Projekt- und Variantenparametern verwendet werden.

  • Die Werte einiger Sonderzeichenfolgen werden erst bei der Erzeugung der entsprechenden Ausgabe sichtbar, darunter .Legend, .Plot_File_Name und .Printout_Name. Die meisten Sonderzeichenfolgen können auf dem Bildschirm angezeigt werden.

    Beim Erstellen der Dokumentation für ein Leiterplattenprojekt und dessen Freigabe in einem Workspace muss angegeben werden können, auf welches Item und welche Revision sich die Dokumentation bezieht, welche Konfiguration des Designprojekts für die Freigabe verwendet wurde und welche Variante gegebenenfalls maßgeblich ist. Hierfür steht eine Reihe spezieller Zeichenfolgen zur Verfügung, darunter .PCBConfigurationName, .ItemAndRevision und .VariantName. Diese speziellen Zeichenfolgen werden erst interpretiert, wenn die Ausgabe erzeugt wird (außer bei der Anzeige der Leiterplatte in 3D, die selbst als Ausgabe gilt). Die durch diese Zeichenfolgen bereitgestellten Informationen sind in den erzeugten Ausgaben sichtbar, darunter Gerber-/ODB++-Dateien, Druckausgaben der finalen Druckvorlagen, Leiterplatten-Druckausgaben, Leiterplatten-3D-Druckausgaben, Leiterplatten-3D-Videos und Bestückungszeichnungen.
  • Spezielle Zeichenfolgen werden für die Bildschirmanzeige automatisch umgewandelt. Kann eine Zeichenfolge nicht umgewandelt werden, wird entweder die eingegebene Zeichenfolge oder eine Meldung angezeigt. Wenn das Projekt beispielsweise nicht unter Versionskontrolle steht und die spezielle Zeichenfolge .VersionControl_RevNumber auf der Leiterplatte platziert wird, erscheint die Meldung Not in Version Control.

  • Um die Identifizierung spezieller Zeichenfolgen zu erleichtern, enthält das Panel Ansichtskonfiguration die Option Special Strings. Wenn diese Option aktiviert ist, werden alle platzierten Textobjekte, die aus umgewandelten speziellen Zeichenfolgen bestehen, mit dem Namen der nicht umgewandelten speziellen Zeichenfolge überlagert (beschriftet).

Platzieren einer speziellen Zeichenfolge

Um eine spezielle Zeichenfolge auf einer Leiterplatte zu verwenden, platzieren Sie ein Textobjekt und wählen Sie anschließend im Panel Properties einen der Namen der speziellen Zeichenfolgen aus der Dropdown-Liste des Felds „Text“ (Modus String) oder aus der Dropdown-Liste  (Modus Frame) aus.

Zugriff auf spezielle Zeichenfolgen für ein platziertes Zeichenfolgenobjekt.
Zugriff auf spezielle Zeichenfolgen für ein platziertes Zeichenfolgenobjekt.

Die folgenden vordefinierten, systembasierten speziellen Zeichenfolgen können in einem Leiterplattendokument verwendet werden:

  • .Application_BuildNumber – die Version der Software, in der die Leiterplatte aktuell geladen ist. Verwenden Sie diese Zeichenfolge beim Erzeugen einer Gerber-Ausgabe, um den Software-Build zu dokumentieren, mit dem das Design erstellt wurde.
  • .Arc_Count – die Anzahl der Kreisbögen auf der Leiterplatte.
  • .BlindVia_Count – die Anzahl der Sackloch-Vias auf der Leiterplatte.
  • .Board_Height – die vertikale Abmessung der Leiterplatte.
  • .Board_Width – die horizontale Abmessung der Leiterplatte. 
  • .BuriedVia_Count – die Anzahl der vergrabenen Vias auf der Leiterplatte.
  • .Comment – die Kommentarzeichenfolge eines Bauteils (im Bibliothekseditor als Teil des Bauteil-Footprints auf einer beliebigen Lage platziert).
  • .Component_Count – die Anzahl der Bauteile auf der Leiterplatte.
  • .ComponentMixed_Count – die Anzahl der Bauteile mit gemischten Pads auf der Leiterplatte.
  • .ComponentSMD_Count – die Anzahl der Bauteile mit SMD-Pads auf der Leiterplatte.
  • .ComponentThru_Count – die Anzahl der Bauteile mit Durchsteck-Pads auf der Leiterplatte.
  • .ComputerName – der Name des Computers, auf dem die Software installiert ist und ausgeführt wird.
  • .CopperInner_Weight_Max – das maximale Kupfergewicht auf den Innenlagen.
  • .CopperOuter_Weight_Max – das maximale Kupfergewicht auf den Außenlagen.
  • .Designator – die Bezeichnerzeichenfolge eines Bauteils (im Bibliothekseditor als Teil des Bauteil-Footprints auf einer beliebigen Lage platziert).
  • .Fill_Count – die Anzahl der Füllflächen auf der Leiterplatte.
  • .Hole_Count – die Anzahl der Bohrungen auf der Leiterplatte.
  • .Hole_Size_Min – der kleinste Bohrungsdurchmesser auf der Leiterplatte.
  • .Hole_Size_Num – die Anzahl der unterschiedlichen Bohrungsdurchmesser auf der Leiterplatte.
  • .Item – das Item, auf das sich die erzeugten Daten beziehen (z. B. D-810-2000). Die Daten werden zur Herstellung dieses Items verwendet.
  • .ItemAndRevision – das Item und dessen spezifische Revision, auf die sich die erzeugten Daten beziehen, im Format <Item ID>-<Revision ID> (z. B. D-810-2000-01.A.1). Die Daten werden zur Herstellung dieser spezifischen Revision des betreffenden Items verwendet.
  • .ItemRevision – die spezifische Revision des Items, auf die sich die erzeugten Daten beziehen (z. B. 01.A.1). Die Daten werden in dieser Item-Revision auf dem Zielserver gespeichert.
  • .ItemRevisionBase – der Anteil der Basisebene im Benennungsschema einer Item-Revision (z. B. 1).
  • .ItemRevisionLevel1 – der Anteil der Ebene 1 im Benennungsschema einer Item-Revision (z. B. A).
  • .ItemRevisionLevel1AndBase – die Anteile der Ebene 1 und der Basisebene im Benennungsschema einer Item-Revision (z. B. A.1).
  • .ItemRevisionLevel2 – der Anteil der Ebene 2 im Benennungsschema einer Item-Revision (z. B. 01).
  • .ItemRevisionLevel2AndLevel1 – die Anteile der Ebene 2 und der Ebene 1 im Benennungsschema einer Item-Revision (z. B. 01.A).
  • .Layer_Count – die Anzahl der Kupferlagen auf der Leiterplatte.
  • .Layer_Name – der Name der Lage, auf der die Zeichenfolge platziert ist.
  • .Legend – eine Symbollegende für mechanische Bohrpläne. Diese Zeichenfolge ist nur gültig, wenn sie auf der Lage „Drill Drawing“ platziert wird. Hinweis: Dies ist eine veraltete Funktion. Platzieren Sie für detailliertere Bohrungsinformationen ein Bohrtabellenobjekt.
  • .MicroVia_Count – die Anzahl der Microvias auf der Leiterplatte.
  • .ModifiedDate – der Datumsstempel der letzten Änderung der Leiterplatte; er wird automatisch eingetragen. Beispiel: 23/09/2015.
  • .ModifiedTime – der Zeitstempel der letzten Änderung der Leiterplatte; er wird automatisch eingetragen.
  • .Net_Count – die Gesamtzahl der unterschiedlichen Netze auf der Leiterplatte.
  • .Net_Names_On_Layer – die Namen aller Netze auf der jeweiligen Lage. Diese Zeichenfolge ist nur gültig, wenn sie auf einer internen Versorgungslage platziert wird.
  • .Pad_Count – die Anzahl der Pads auf der Leiterplatte.
  • .PadSMD_Count – die Anzahl der SMD-Pads auf der Leiterplatte.
  • .PadThru_Count – die Anzahl der Durchsteck-Pads auf der Leiterplatte.
  • .Pattern – die Namen der auf der Leiterplatte verwendeten Bauteil-Footprints.
  • .Pcb_File_Name – der Pfad und Dateiname des Leiterplattendokuments.
  • .Pcb_File_Name_No_Path – der Dateiname des Leiterplattendokuments.
  • .PCBConfigurationName – zeigt den Namen des Datensatzes an, aus dem die Ausgabe erzeugt wurde, wie im Project Releaser definiert. Beachten Sie, dass die Namen der Standardkonfigurationen Source, Fabrication und Assembly nicht bearbeitet werden können (beispielsweise wird bei der Fertigungsausgabe für .PCBConfigurationName „Fabrication“ angezeigt). Bei benutzerdefinierten Konfigurationen wird bei Verwendung dieser speziellen Zeichenfolge der benutzerdefinierte Name angezeigt (Bild anzeigen).
  • .Plot_File_Name – bei erzeugten Gerber-Ausgaben gibt diese Zeichenfolge den Dateinamen der Gerber-Plotdatei an. Bei Druckausgaben gibt sie die in der Ausgabe dargestellte Lage an. Bei ODB++-Ausgaben gibt sie den Namen des übergeordneten Ordners an, in dem die Dateien gespeichert sind.
  • .Poly_Count – die Anzahl der Polygone auf der Leiterplatte (bestehend aus Polygonflächen, Innenlagen und geteilten Versorgungslagen).
  • .Print_Date – das Datum des Druckens/Plottens.
  • .Print_Scale – der Skalierungsfaktor für das Drucken/Plotten.
  • .Print_Time – die Uhrzeit des Druckens/Plottens.
  • .Printout_Name – der Name des Ausdrucks.
  • .SlotHole_Count – die Anzahl der Langlöcher auf der Leiterplatte.
  • .SolderMask_Bottom – Vorhandensein einer unteren Lötstoppmaske. Wenn keine untere Lötstoppmaskenlage vorhanden ist, hat der Parameter den Wert No mask. Wenn eine untere Lötstoppmaskenlage vorhanden ist, deren Farbe jedoch nicht definiert ist, hat der Parameter den Wert No color. Wenn eine untere Lötstoppmaskenlage mit definierter Farbe vorhanden ist, zeigt der Parameter die Farbe an, entweder als Namen (Green, Black, Blue, Red usw.) oder als RGBA-Code (z. B. #FF0065FF).
  • .SolderMask_Top – Vorhandensein einer oberen Lötstoppmaske. Wenn keine obere Lötstoppmaskenlage vorhanden ist, hat der Parameter den Wert No mask. Wenn eine obere Lötstoppmaskenlage vorhanden ist, deren Farbe jedoch nicht definiert ist, hat der Parameter den Wert No color. Wenn eine obere Lötstoppmaskenlage mit definierter Farbe vorhanden ist, zeigt der Parameter die Farbe an, entweder als Namen (Green, Black, Blue, Red usw.) oder als RGBA-Code (z. B. #FF0065FF).
  • .SquareHole_Count – die Anzahl der quadratischen Löcher auf der Leiterplatte.
  • .StackedVia_Count – die Anzahl der gestapelten Vias auf der Leiterplatte.
  • .String_Count – die Anzahl der Zeichenfolgen auf der Leiterplatte.
  • .Thru_Via_Count – die Anzahl der durchgehenden Vias auf der Leiterplatte.
  • .Total_Thickness – die Dicke der Leiterplatte.
  • .Total_Thickness(Board Layer Stack) – die Dicke des Lagenaufbaus der Leiterplatte.
  • .Track_Count – die Anzahl der Leiterbahnen auf der Leiterplatte.
  • .VariantName – die Variante des Designs, aus der die Ausgabe erstellt wurde.
  • .VersionControl_PrjFolderRevNumber – die aktuelle Revisionsnummer des Projekts, die bei jedem vollständigen Commit des Projekts (d. h. einschließlich der Projektdatei) erhöht wird. Damit diese Zeichenfolge Informationen enthält, muss eine Versionsverwaltung verwendet werden.
  • .VersionControl_ProjFolderRevNumber – die aktuelle Revisionsnummer des Projekts, die bei jedem vollständigen Commit des Projekts (d. h. einschließlich der Projektdatei) erhöht wird. Damit diese Zeichenfolge Informationen enthält, muss eine Versionsverwaltung verwendet werden.
  • .VersionControl_ProjFolderRevNumberShort – ein verkürzter Git-Hash (die ersten acht Zeichen) des Projekts. Damit diese Zeichenfolge Informationen enthält, muss eine Versionsverwaltung verwendet werden.
  • .VersionControl_RevNumber – die aktuelle Revisionsnummer des Dokuments. Damit diese Zeichenfolge Informationen enthält, muss eine Versionsverwaltung verwendet werden.
  • .VersionControl_RevNumberShort – ein verkürzter Git-Hash (die ersten acht Zeichen) der aktuellen Revision des Dokuments. Damit diese Zeichenfolge Informationen enthält, muss eine Versionsverwaltung verwendet werden.
  • .Via_Count – die Anzahl der Vias auf der Leiterplatte.
Die vollständige Liste der verfügbaren Sonderzeichenfolgen enthält auch alle Zeichenfolgen, die aus benutzerdefinierten Parametern auf Projektebene abgeleitet werden.
AI-LocalizedKI-lokalisiert
Wenn Sie ein Problem feststellen, wählen Sie den Text/das Bild aus und drücken SieCtrl + Enter, um uns Ihr Feedback zu senden.
Nav
Contents
Funktionsverfügbarkeit

Die Ihnen zur Verfügung stehenden Funktionen hängen davon ab, über welche Altium-Lösung Sie verfügen – Altium Develop, Altium Agile Teams, Altium Agile Enterprise oder Altium Designer (mit aktivem Laufzeitvertrag).

Wenn Sie eine dokumentierte Funktion in Ihrer tatsächlich verwendeten Software nicht sehen, wenden Sie sich an den Altium-Vertrieb, um mehr zu erfahren.

Legacy-Dokumentation

Die Dokumentation von Altium Designer wird nicht mehr versioniert. Wenn Sie auf Dokumentation für ältere Versionen von Altium Designer zugreifen müssen, besuchen Sie den Abschnitt Legacy-Dokumentation auf der Seite Andere Installer.

Contents