# Elementname: `While`

## Beschreibung

Erzeugt eine Schleife, die wiederholt durchlaufen wird. Die Kindelemente werden so oft ausgeführt, solange die Bedingung im Attribut bedingung wahr ergibt.

Erlaubte Attribute: test

Kindelemente: Action, Attribute, B, Barcode, Bookmark, Br, Column, Columns, Copy-of, DefineColor, DefineFontalias, DefineFontfamily, DefineTextformat, Element, Fontface, ForAll, Frame, Group, HSpace, Hyphenation, I, Image, Include, InsertPages, Li, LoadDataset, LoadFontfile, Loop, Message, NewPage, NextFrame, NextRow, Options, Output, Pageformat, Paragraph, PlaceObject, PositioningArea, PositioningFrame, ProcessNode, SaveDataset, SavePages, SetGrid, SetVariable, SortSequence, Sub, Sup, Switch, Table, Tablehead, Tablerule, Td, Tr, Trace, Until, Value, While

Elternelemente: AtPageCreation, AtPageShipout, Case, Contents, ForAll, Loop, Otherwise, Record, SavePages, Until, While

### Attribute

test (XPath Ausdruck)

  Für jedes Mal, das die Schleife durchlaufen werden soll, muss die Bedingung im Attribut erfüllt sein. Die Bedingung wird am Anfang der Schleife überprüft. Eine Schleife, bei der die Bedingung am Ende der Schleife geprüft wird, ist Until.

## Beispiel

Folgendes Beispiel erzeugt einen Textblock mit dem Inhalt „Text Text Text“.

    <Record element="url">
      <SetVariable variable="zaehler" select="1"/>
      <SetVariable variable="text" select="''"/>
      <While test=" $zaehler &lt;= 3 "> <!-- kleiner oder gleich -->
        <SetVariable variable="zaehler" select=" $zaehler + 1"/>
        <SetVariable variable="text">
          <Value select="$text"/>
          <Value select="'Text '"/>
        </SetVariable>
      </While>
      <PlaceObject column="1">
        <Textblock width="10">
          <Paragraph><Value select="$text"></Value></Paragraph>
        </Textblock>
      </PlaceObject>
    </Record>

## Siehe auch

Switch, SetVariable, Until

# Befehlsübersicht

- A
- Action
- AddToList
- AtPageCreation
- AtPageShipout
- Attribute
- B
- Barcode
- Bold
- BoldItalic
- Bookmark
- Box
- Br
- Case
- Circle
- Color
- Column
- Columns
- Compatibility
- Contents
- Copy-of
- DefineColor
- DefineFontalias
- DefineFontfamily
- DefineTextformat
- Element
- Fontface
- ForAll
- Frame
- Grid
- Group
- HSpace
- Hyphenation
- I
- Image
- Include
- InsertPages
- Italic
- Layout
- Li
- LoadDataset
- LoadFontfile
- Loop
- Makeindex
- Margin
- Mark
- Message
- NewPage
- NextFrame
- NextRow
- NoBreak
- Ol
- Options
- Otherwise
- Output
- Overlay
- PDFOptions
- Pageformat
- Pagetype
- Paragraph
- PlaceObject
- Position
- PositioningArea
- PositioningFrame
- ProcessNode
- Record
- Regular
- Rule
- SaveDataset
- SavePages
- Sequence
- SetGrid
- SetVariable
- SortSequence
- Stylesheet
- Sub
- Sup
- Switch
- Table
- Tablefoot
- Tablehead
- Tablerule
- Td
- Text
- Textblock
- Tr
- Trace
- Transformation
- U
- URL
- Ul
- Until
- VSpace
- Value
- While

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