FC_DisplayMessageWrite

 

FC_DisplayMessageWrite - Allgemeine Informationen

Übersicht

Typ

Funktion

Verfügbar ab

SystemInterface_1.32.6.0

Versionen:

Aktuelle Version

Aufgabe

Text im Display (an beliebiger Stelle) ausgeben.

Beschreibung

Mit Hilfe dieser Funktion ist es möglich, einen i_sDisplayString-Text an einer beliebigen Stelle innerhalb des Steuerungsdisplays (PacDrive LMC Pro, PacDrive LMC Eco) auszugeben. Im Gegensatz zur Funktion FC_DisplayLineWrite() wird der Text in der nächsten Zeile fortgesetzt und kann also über mehrere Zeilen hinweg geschrieben werden. Mit i_uiLine wird die Zeile festgelegt, in die das erste Zeichen geschrieben werden soll. Mit i_uiPosition wird die Startposition für den Text innerhalb der Zeile festgelegt.

Über das Flag i_xClearDisplay kann ausgewählt werden, ob das Display vorher gelöscht wird bzw. der Text nur überschrieben wird.

Ist der Text länger als die verfügbare Anzahl an Zeichen auf dem Display, wird er auf die anzeigbare Länge gekürzt.

Schnittstelle

Eingang

Datentyp

Beschreibung

i_uiLine

UINT

Zeile, in die das erste Zeichen geschrieben werden soll

i_uiPosition

UINT

Startposition des Texts innerhalb der Zeile

i_sDisplayString

STRING[200]

Zu schreibender Text

i_xClearDisplay

BOOL

Löschen Sie den Inhalt des Displays zuerst. Ansonsten wird der Text überschrieben.

Rückgabewert

Datentyp

Beschreibung

DINT

0: OK.

-1: Funktion für Steuerung nicht verfügbar.

-2: Interner Fehler.

-3: Display befindet sich nicht im IEC-Modus.

-10: Zu schreibender String befindet sich außerhalb des verfügbaren Bereichs.

Beispiele

sDisplayString:='FC_DisplayMessageWrite -> ->';
lResult:=FC_DisplayMessageWrite(uiLine+1, uiPosition, sDisplayString, bClearDisplay);
IF lResult < 0 THEN
   sResult := 'Error: FC_DisplayMessageWrite';
END_IF;