Textfelder und Programmdokumentation

Mit Text können beschreibende Elemente direkt auf dem Programmfeld eingefügt werden. Ein Textfeld besitzt keine Ein- oder Ausgänge und beeinflusst die Ausführung des Programms nicht.

Textfeld einfügen

In der Toolbox steht oberhalb der Funktionsgruppen der Eintrag Text zur Verfügung. Nach dem Einfügen erscheint ein Textfeld mit einem Titel und einem Textbereich.

Eigenschaften

Ein Textfeld besitzt zwei wesentliche Inhalte:

• Titel – kurze Überschrift des Abschnitts
• Text – ausführlichere Beschreibung oder Hinweis

Beide Inhalte können über die Eigenschaftenansicht geändert werden.

Sinnvolle Verwendung

Textfelder eignen sich besonders für:

• Beschreibung eines Programmabschnitts,
• Kennzeichnung von Heizungs-, Beschattungs- oder Alarmfunktionen,
• Dokumentation der Bedeutung eines Grenzwerts,
• Hinweis auf externe Verdrahtung,
• Wartungs- oder Inbetriebnahmehinweise,
• Trennung mehrerer unabhängiger Funktionen in einem großen Programm.

Beispiel:

┌──────────────────────────────────┐
│ Frostschutz                      │
│ Aktiviert Ausgang 2 bei          │
│ Außentemperatur unter 3 °C.      │
└──────────────────────────────────┘

Textfelder werden nicht ausgeführt

Textfelder:

• benötigen keine Verbindungen,
• werden bei der Signalverarbeitung ignoriert,
• verhindern die Übertragung nicht,
• dienen ausschließlich der Dokumentation.

Empfehlungen

Verwende kurze Titel und beschreibe nur Informationen, die für das Verständnis oder die Wartung des Programms relevant sind. Besonders bei mehreren ähnlichen Funktionsketten reduzieren Textfelder die Gefahr, später den falschen Programmteil zu ändern.