AddHeader [MHD]

Top  Previous  Next

Einfügen eines Blattkopfattributes (Header) in einen Plan. Die Prozedur fügt entweder einen neuen Header mit einem Wert ein oder überschreibt einen vorhandenen. Es lassen sich mit dieser Prozedur auch existierende Blattkopfattribute löschen, indem kein Wert eingegeben wird.

 

Voraussetzung

Ein Plan muß geöffnet sein.

Parameter

LBL/<txt>

Mit dem Parameter LBL können Blattkopfattribute in der Kommandozeile mit übergeben werden. Es erfolgt dann kein Dialog, in dem die Werte abgefragt werden. Sollen auch Leerzeichen in der Headerbezeichnung vorkommen, so muß der gesamte Text in Anführungszeichen gesetzt werden.

QTX/n

Mit dem Parameter QTX können Werte aus dem Textpuffer oder aus einer Texttabelle genommen werden, über die entsprechende Zahl n. Ist der Wert -1, so wird der aktuelle Text aus dem Textpuffer genommen. Ein Wert größer als -1 entspricht einen Eintrag in einer Texttabelle.

TXT/<txt>

Mit dem Parameter TXT können ebenfalls Blattkopfattributwerte direkt übergeben werden. Es erfolgt dann kein Dialog, in dem der Wert abgefragt wird. Sollen auch Leerzeichen im Text vorkommen, so muß der gesamte Text in Anführungszeichen gesetzt werden.

/FORCE

Der vorhandene Wert wird ohne Warnung überschrieben.

/SEGMENT

Das Attribut wird an die offene Ebene geschrieben.

SEGMENT/nnn

Es wird in die Ebene nnn geschrieben.

/H

Mit diesem Schalter wird ein Hilfetext und die Aufrufkonvention angezeigt.

Rückgabewert

 

Wert

Beschreibung

0

Aufruf wurde erfolgreich durchgeführt

Sonst

Fehler aufgetreten

Dialog

Wenn ein Parameter nicht angegeben wird dann wird er abgefragt.

Attributname:

Es wird der Attributname abgefragt, unter dem der Attributwert abgelegt wird.

Wert des Attributs:

Zu dem entsprechenden Attributnamen wird hier der Attributwert abgefragt.

Existiert schon das entsprechende Attribut, erscheint folgender Dialog:

Blattkopfattribut schon vorhanden. Löschen? [Ja/Nein]

Wird mit Ja geantwortet, wird der alte Wert durch den neuen Wert ersetzt. Bei Nein wird der alte Wert nicht gelöscht und der neue Wert wird nicht übernommen.

Wenn ein Fehler aufgetreten ist und das Blattkopfattribut nicht hinzugefügt wurde, erscheint die Meldung:

Blattkopfattribut konnte nicht angelegt werden

Beispiel

AddHeader LBL/Autor TXT/Heinz

Einfügen des Attributs Autor mit dem Wert Heinz.

AddHeader LBL/Text TXT/dies ist ein Header mit Blanks

Parameter mit Blanks müssen in geschlossen werden.

AddHeader LBL/A b TXT/wert

Auch der Name eines Attributs darf Leerzeichen enthalten.

Bemerkung

Siehe auch

ViewHeader [VHD]