====== API: Bars/Ribbon Controls ======

API-Referenz für Menüleisten, Toolbars und Ribbon.

===== TWvdSBarManager =====

Manager für Menüs und Toolbars.

==== Namespace ====

''WvdS.UI.Controls.Bars''

==== PXAML ====

<code xml>
<BarManager>
  <BarManager.MainMenu>
    <Bar>
      <BarSubItem Caption="File">
        <BarButton Caption="New" Command="{Binding NewCommand}" Shortcut="Ctrl+N" />
        <BarButton Caption="Open" Command="{Binding OpenCommand}" Shortcut="Ctrl+O" />
        <BarSeparator />
        <BarButton Caption="Exit" Command="{Binding ExitCommand}" />
      </BarSubItem>
      <BarSubItem Caption="Edit">
        <BarButton Caption="Undo" Command="{Binding UndoCommand}" Shortcut="Ctrl+Z" />
        <BarButton Caption="Redo" Command="{Binding RedoCommand}" Shortcut="Ctrl+Y" />
      </BarSubItem>
    </Bar>
  </BarManager.MainMenu>
  <BarManager.Toolbars>
    <Bar Name="Standard">
      <BarButton Caption="New" Icon="new" Command="{Binding NewCommand}" />
      <BarButton Caption="Open" Icon="open" Command="{Binding OpenCommand}" />
      <BarButton Caption="Save" Icon="save" Command="{Binding SaveCommand}" />
    </Bar>
  </BarManager.Toolbars>
</BarManager>
</code>

==== Properties ====

| Property | Typ | Default | Beschreibung |
^ MainMenu | TBar | nil | Hauptmenü |
^ Toolbars | TBarCollection | nil | Toolbars |
^ PopupMenus | TPopupMenuCollection | nil | Kontextmenüs |
^ AllowCustomization | Boolean | True | Anpassung erlaubt |

----

===== TWvdSRibbonControl =====

Microsoft Office-Style Ribbon.

==== Namespace ====

''WvdS.UI.Controls.Bars''

==== PXAML ====

<code xml>
<RibbonControl ApplicationButtonText="File">
  <RibbonControl.ApplicationMenu>
    <RibbonApplicationMenu>
      <BarButton Caption="New" Icon="new" Command="{Binding NewCommand}" />
      <BarButton Caption="Open" Icon="open" Command="{Binding OpenCommand}" />
      <BarButton Caption="Save" Icon="save" Command="{Binding SaveCommand}" />
      <BarSeparator />
      <BarButton Caption="Exit" Command="{Binding ExitCommand}" />
    </RibbonApplicationMenu>
  </RibbonControl.ApplicationMenu>

  <RibbonPage Caption="Home">
    <RibbonGroup Caption="Clipboard">
      <BarButton Caption="Paste" Icon="paste" Size="Large" />
      <BarButton Caption="Cut" Icon="cut" />
      <BarButton Caption="Copy" Icon="copy" />
    </RibbonGroup>
    <RibbonGroup Caption="Font">
      <BarEditItem>
        <ComboBoxEdit Width="100" ItemsSource="{Binding Fonts}" />
      </BarEditItem>
      <BarButton Caption="Bold" Icon="bold" IsToggle="True" />
      <BarButton Caption="Italic" Icon="italic" IsToggle="True" />
    </RibbonGroup>
  </RibbonPage>

  <RibbonPage Caption="Insert">
    <RibbonGroup Caption="Tables">
      <BarButton Caption="Table" Icon="table" Size="Large" />
    </RibbonGroup>
  </RibbonPage>
</RibbonControl>
</code>

==== Properties ====

| Property | Typ | Default | Beschreibung |
^ Pages | TRibbonPageCollection | nil | Ribbon-Seiten |
^ SelectedPage | TRibbonPage | nil | Aktive Seite |
^ ApplicationButtonText | string | '' | App-Button-Text |
^ ApplicationMenu | TRibbonApplicationMenu | nil | App-Menü |
^ QuickAccessToolbar | TBar | nil | Schnellzugriff |
^ IsMinimized | Boolean | False | Ribbon minimiert |
^ Style | TRibbonStyle | rsOffice2019 | Office2007, Office2010, Office2013, Office2016, Office2019 |

----

===== TWvdSRibbonPage =====

Ribbon-Seite (Tab).

==== Namespace ====

''WvdS.UI.Controls.Bars''

==== Properties ====

| Property | Typ | Default | Beschreibung |
^ Caption | string | '' | Tab-Titel |
^ Groups | TRibbonGroupCollection | nil | Gruppen |
^ IsVisible | Boolean | True | Sichtbar |
^ ContextualTabGroup | string | '' | Kontextueller Tab |

----

===== TWvdSRibbonGroup =====

Ribbon-Gruppe innerhalb einer Seite.

==== Namespace ====

''WvdS.UI.Controls.Bars''

==== Properties ====

| Property | Typ | Default | Beschreibung |
^ Caption | string | '' | Gruppenname |
^ Items | TBarItemCollection | nil | Enthaltene Items |
^ ShowDialogLauncher | Boolean | False | Dialog-Launcher |
^ CollapsePriority | Integer | 0 | Collapse-Priorität |

----

===== TWvdSBarButton =====

Toolbar/Menü-Button.

==== Namespace ====

''WvdS.UI.Controls.Bars''

==== PXAML ====

<code xml>
<BarButton Caption="Save"
           Icon="save"
           Command="{Binding SaveCommand}"
           Shortcut="Ctrl+S"
           Hint="Save the current document" />
</code>

==== Properties ====

| Property | Typ | Default | Beschreibung |
^ Caption | string | '' | Button-Text |
^ Icon | TWvdSImageSource | nil | Icon |
^ Command | IWvdSCommand | nil | Command |
^ Shortcut | string | '' | Tastenkürzel |
^ Hint | string | '' | Tooltip |
^ Size | TBarButtonSize | bsSmall | Small, Large |
^ IsToggle | Boolean | False | Toggle-Button |
^ IsPressed | Boolean | False | Toggle-Status |
^ IsEnabled | Boolean | True | Aktiviert |

==== Events ====

| Event | Signatur | Beschreibung |
^ OnClick | TNotifyEvent | Button geklickt |

----

===== TWvdSBarSubItem =====

Untermenü.

==== Namespace ====

''WvdS.UI.Controls.Bars''

==== PXAML ====

<code xml>
<BarSubItem Caption="Recent Files">
  <BarButton Caption="Document1.txt" />
  <BarButton Caption="Document2.txt" />
  <BarSeparator />
  <BarButton Caption="Clear Recent" />
</BarSubItem>
</code>

==== Properties ====

| Property | Typ | Default | Beschreibung |
^ Caption | string | '' | Menü-Text |
^ Icon | TWvdSImageSource | nil | Icon |
^ Items | TBarItemCollection | nil | Untermenü-Items |

----

===== TWvdSBarEditItem =====

Editor in Toolbar/Menü.

==== Namespace ====

''WvdS.UI.Controls.Bars''

==== PXAML ====

<code xml>
<BarEditItem Caption="Zoom:">
  <SpinEdit Value="{Binding ZoomLevel}"
            Minimum="25" Maximum="400"
            Width="80" />
</BarEditItem>
</code>

==== Properties ====

| Property | Typ | Default | Beschreibung |
^ Caption | string | '' | Label |
^ Edit | TWvdSControl | nil | Editor-Control |
^ Width | Integer | 100 | Breite |

----

===== TWvdSStatusBar =====

Statusleiste.

==== Namespace ====

''WvdS.UI.Controls.Bars''

==== PXAML ====

<code xml>
<StatusBar>
  <StatusBarItem Content="{Binding StatusText}" Width="*" />
  <StatusBarItem>
    <ProgressBar Value="{Binding Progress}" Width="100" />
  </StatusBarItem>
  <StatusBarItem Content="{Binding LineColumn}" Width="100" />
</StatusBar>
</code>

==== Properties ====

| Property | Typ | Default | Beschreibung |
^ Items | TStatusBarItemCollection | nil | Status-Items |

==== TWvdSStatusBarItem ====

| Property | Typ | Beschreibung |
^ Content | TValue | Inhalt (Text oder Control) |
^ Width | TGridLength | Breite (Auto, *, Pixel) |
^ Alignment | TAlignment | Links, Mitte, Rechts |

----

===== TWvdSAlertControl =====

Benachrichtigungen/Toasts.

==== Namespace ====

''WvdS.UI.Controls.Bars''

==== Syntax ====

<code pascal>
AlertControl.Show('Operation completed successfully',
  TAlertType.atSuccess, 3000);

AlertControl.Show('Error occurred', TAlertType.atError);
</code>

==== Properties ====

| Property | Typ | Default | Beschreibung |
^ Position | TAlertPosition | apTopRight | TopLeft, TopRight, BottomLeft, BottomRight |
^ DefaultDuration | Integer | 5000 | Anzeigedauer (ms) |
^ MaxAlerts | Integer | 5 | Max. gleichzeitige Alerts |

==== Methoden ====

| Methode | Beschreibung |
^ Show(text, type, duration) | Alert anzeigen |
^ ShowInfo(text) | Info-Alert |
^ ShowSuccess(text) | Erfolgs-Alert |
^ ShowWarning(text) | Warnung |
^ ShowError(text) | Fehler-Alert |
^ CloseAll | Alle schließen |

----

===== TWvdSPopupMenu =====

Kontextmenü.

==== Namespace ====

''WvdS.UI.Controls.Bars''

==== PXAML ====

<code xml>
<DataGrid ContextMenu="{StaticResource GridContextMenu}" />

<PopupMenu x:Key="GridContextMenu">
  <BarButton Caption="Edit" Command="{Binding EditCommand}" />
  <BarButton Caption="Delete" Command="{Binding DeleteCommand}" />
  <BarSeparator />
  <BarSubItem Caption="Export">
    <BarButton Caption="Excel" Command="{Binding ExportExcel}" />
    <BarButton Caption="PDF" Command="{Binding ExportPdf}" />
  </BarSubItem>
</PopupMenu>
</code>

==== Properties ====

| Property | Typ | Default | Beschreibung |
^ Items | TBarItemCollection | nil | Menü-Items |

==== Methoden ====

| Methode | Beschreibung |
^ ShowAt(x, y) | Menü an Position anzeigen |
^ ShowAtCursor | Menü an Cursor anzeigen |
^ Close | Menü schließen |

----

===== Siehe auch =====

  * [[.:control-bibliothek|Control-Bibliothek]]
  * [[.:api-controls-navigation|Navigation Controls API]]
  * [[.:api-controls-basic|Basic Controls API]]