# Elementname: `ObjektAusgeben`

## Beschreibung

Gibt ein rechteckiges Objekt (Bild, Tabelle, Box oder Textblock) aus.

Erlaubte Attribute: behalteposition, belegen, bereich, drehen, gruppenname, hintergrund, hintergrundfarbe, hreferenz, linienstärke, maxhöhe, rahmen, rahmen-oben-links-radius, rahmen-oben-rechts-radius, rahmen-unten-links-radius, rahmen-unten-rechts-radius, rahmenfarbe, seite, spalte, ursprung-x, ursprung-y, valign, vreferenz, zeile

Kindelemente: Bild, Box, Linie, Rahmen, Strichcode, Tabelle, Textblock, Transformation

Elternelemente: BeiSeitenAusgabe, BeiSeitenErzeugung, Bis, Datensatz, Fall, FürAlle, Inhalt, Schleife, SeitenSpeichern, Solange, Sonst

### Attribute

behalteposition (optional)

  Den virtuellen Cursor nicht verändern.

  ja: | Den virtuellen Cursor nicht verändern.
  nein: | Den virtuellen Cursor verschieben (Voreinstellung)

belegen (optional)

  Bestimmt, ob im Raster der Platz für das Objekt als »belegt« markiert wird. Bei belegen=“nein” wird auch die aktuelle Zeile im Raster nicht verändert. Bei “auto” wird bei Bildern der Bildumriss beachtet, sofern eine Umrissdatei vorliegt. Siehe die Beschreibung bei Bild

  ja: | Platz im Raster reservieren (Voreinstellung für Platzierung im Raster).
  nein: | Bereich nicht als Belegt markieren (Voreinstellung für absolute Positionierung)

bereich (Text, optional)

  Name des Bereichs (Platzierungsbereich), in dem das Objekt ausgegeben werden soll. Wird kein Bereich angegeben, so wird das Objekt auf der »Seite« (dem Bereich, der alle Rasterkästen beinhaltet) ausgegeben.

drehen (Zahl, optional)

  Experimentell / Obsolete. Dreht das Objekt. Ein Winkel > 0 dreht das Objekt im Uhrzeigersinn, ein Winkel < 0 gegen den Uhrzeigersinn.

gruppenname (Text, optional)

  Wenn eine Gruppe ausgegeben werden soll, muss der Name hier angegeben werden.

hintergrund (optional)

  Erzeugt einen farbigen Hintergrund für das Objekt. Das Attribut ›hintergrundfarbe‹ gibt die Farbe an.

  vollständig: | Den Hintergrund in der angegebenen Farbe füllen (in hintergrundfarbe)
  ohne: | Leerer Hintergrund

hintergrundfarbe (Text, optional)

  Hintergrundfarbe wenn das Objekt mit einer Farbe hinterlegt werden soll.

hreferenz (optional)

  Bestimmt, ob die angegebene Spalte die linke oder die rechte Kante vom Objekt bezeichnet.

  links: | Das Objekt wird in der angegebenen Spalte platziert.
  rechts: | Das Objekt wird mit dem rechten Rand in der gegebenen Spalte ausgerichtet.

linienstärke (length, optional)

  Die Dicke des Rahmnes, der um das Objekt gezogen wird. Nur sinnvoll zusammen mit dem Attribut rahmen.

maxhöhe (Zahl, optional)

  Die maximale Höhe in Rasterzellen, die das Objekt belegen darf. Wird nur für den automatischen Tabellenumbruch benötigt. Die umbrochenen Tabellen auf den Folgeseiten haben maximal die angegebene Höhe.

rahmen (optional)

  Es wird ein Rahmen um das Objekt gezeichnet. Zusätzlich muss die Rahmenfarbe angegeben werden.

  durchgezogen: | Einen Rahmen um das Objekt zeichnen.
  ohne: | Keinen Rahmen zeichnen.

rahmen-oben-links-radius (length, optional)

  Radius der Ecke oben links.

rahmen-oben-rechts-radius (length, optional)

  Radius der Ecke oben rechts.

rahmen-unten-links-radius (length, optional)

  Radius der Ecke unten links.

rahmen-unten-rechts-radius (length, optional)

  Radius der Ecke unten rechts.

rahmenfarbe (Text, optional)

  Die Farbe des Rahmens, wenn ein Rahmen ausgegeben wird. Nur sinnvoll zusammen mit dem Attribut rahmen.

seite (Zahl, optional)

  Die Seite (später im PDF), auf der das Objekt erscheinen soll. Angabe als Zahl oder »next« für die nächste Seite.

spalte (Zahl oder Längenangabe, optional)

  Zahl: Die Zeile im Raster, in der das Objekt ausgegeben wird. Wird die Zeile nicht angegeben, so sucht sich das System selbständig eine passende freie Zeile für das Objekt. Maßangabe: die Position von der oberen Blattkante.

ursprung-x (optional)

  Der Ursprung für die Drehung

  links: | Der Ursprung liegt links.
  mitte: | Der Ursprung liegt im Mittelpunkt des Objekts.
  rechts: | Der Ursprung liegt rechts.

ursprung-y (optional)

  Der Ursprung der Drehung (vertikale Achse)

  oben: | Rotation um die obere Kante des Objekts.
  mitte: | Rotation um die vertikale Mitte.
  unten: | Um einen Punkt am unteren Rand rotieren.

valign (optional)

  Wird ein Objekt ausgegeben, das kein vielfaches der Rasterhöhe ist, dann gibt das Attribut die vertikale Ausrichtung an. Bottom beispielsweise bedeutet, dass der freie Platz oberhalb des Objekts bleibt. Voreinstellung ist “top”.

  top: | Das Objekt wird oben ausgerichtet.
  middle: | Das Objekt wird so platziert, dass der Leerraum überhalb und unterhalb derselbe ist.
  bottom: | Das Objekt wird unten ausgerichtet.

vreferenz (optional)

  Bestimmt die Platzierung des Objekts relativ zur angegebenen Zeile.

  bottom: | Die Zeile gibt die untere Kante des Objekts an.
  top: | Die Zeile gibt die obere Kante des Objekts an (Voreinstellung).

zeile (Zahl oder Längenangabe, optional)

  Zahl: Die Zeile im Raster, in der das Objekt ausgegeben wird. Wird die Zeile nicht angegeben, so sucht sich das System selbständig eine passende freie Zeile für das Objekt. Maßangabe: die Position von der oberen Blattkante.

## Beispiel

    <Datensatz element="bild">
      <ObjektAusgeben spalte="12" rahmen="durchgezogen" rahmenfarbe="Rot">
        <Bild breite="10" datei="_samplea.pdf" />
      </ObjektAusgeben>
    </Datensatz>

Absolute Platzierung:

    <Datensatz element="bild">
      <ObjektAusgeben spalte="1cm" zeile="4cm" rahmen="durchgezogen" rahmenfarbe="Rot">
        <Bild breite="10" datei="_samplea.pdf" />
      </ObjektAusgeben>
    </Datensatz>

## Hinweis

Die Ausgabe kann entweder im Raster erfolgen (Angabe bei zeile und spalte ist eine Zahl) oder als absolute Positionierung (die Angaben bei zeile und spalte müssen beide vorhanden sein und eine Maßgangabe sein).

## Siehe auch

Bild, Box, Tlinie, Tabelle, Textblock, DefiniereFarbe, Ausgabe

# Befehlsübersicht

- A
- Absatz
- Aktion
- Attribut
- Ausgabe
- B
- BearbeiteKnoten
- BeiSeitenAusgabe
- BeiSeitenErzeugung
- Bild
- Bis
- Box
- Br
- Datensatz
- DefiniereFarbe
- DefiniereSchriftfamilie
- DefiniereTextformat
- Element
- Fall
- Fallunterscheidung
- Farbe
- Fett
- FettKursiv
- FürAlle
- Gruppe
- HLeerraum
- I
- Include
- Indexerstellen
- Inhalt
- Kopie-von
- Kursiv
- LadeDatensatzdatei
- LadeSchriftdatei
- Layout
- Leerzeile
- Lesezeichen
- Li
- Linie
- Marke
- Nachricht
- NeueSeite
- NeueZeile
- Normal
- NächsterRahmen
- ObjektAusgeben
- Ol
- Optionen
- Platzierungsbereich
- Platzierungsrahmen
- Rahmen
- Rand
- Raster
- Schleife
- Schriftart
- SeitenEinfügen
- SeitenSpeichern
- Seitenformat
- Seitentyp
- Sequenz
- SetzeRaster
- Solange
- Sonst
- SortiereSequenz
- Spalte
- Spalten
- SpeichereDatensatzdatei
- Strichcode
- Stylesheet
- Sub
- Sup
- Tabelle
- Tabellenfuß
- Tabellenkopf
- Td
- Text
- Textblock
- Tlinie
- Tr
- Transformation
- Trennvorschlag
- U
- URL
- Ul
- VLeerraum
- Wert
- ZurListeHinzufügen
- Zuweisung

Version: 2.2.0 | Startseite | Befehlsreferenz | Andere Sprache: Englisch