====== API: Navigation Controls ======

API Reference for navigation and wizard controls.

===== TWvdSTabControl =====

Tab-based navigation.

==== Namespace ====

''WvdS.UI.Controls.Navigation''

==== PXAML ====

<code xml>
<TabControl SelectedIndex="{Binding ActiveTab}">
  <TabItem Header="General">
    <GeneralSettings />
  </TabItem>
  <TabItem Header="Advanced">
    <AdvancedSettings />
  </TabItem>
</TabControl>
</code>

==== Properties ====

| Property | Type | Default | Description |
^ Items | TWvdSTabItemCollection | nil | Tab items |
^ SelectedIndex | Integer | 0 | Active tab index |
^ SelectedItem | TWvdSTabItem | nil | Active tab item |
^ TabStripPlacement | TWvdSPlacement | pTop | Top, Bottom, Left, Right |
^ IsClosable | Boolean | False | Tabs closable |

==== Events ====

| Event | Signature | Description |
^ OnSelectionChanged | TSelectionChangedEvent | Tab changed |
^ OnTabClosing | TTabClosingEvent | Tab is closing |

==== TWvdSTabItem ====

<code pascal>
TWvdSTabItem = class(TWvdSContentControl)
  property Header: string;
  property Content: TWvdSFrameworkElement;
  property IsEnabled: Boolean;
  property Icon: TWvdSImageSource;
end;
</code>

----

===== TWvdSAccordion =====

Collapsible panels.

==== Namespace ====

''WvdS.UI.Controls.Navigation''

==== PXAML ====

<code xml>
<Accordion ExpandMode="Single">
  <AccordionItem Header="Section 1" IsExpanded="True">
    <ContentPanel1 />
  </AccordionItem>
  <AccordionItem Header="Section 2">
    <ContentPanel2 />
  </AccordionItem>
</Accordion>
</code>

==== Properties ====

| Property | Type | Default | Description |
^ Items | TWvdSAccordionItemCollection | nil | Accordion items |
^ ExpandMode | TWvdSExpandMode | emSingle | Single, Multiple |
^ SelectedItem | TWvdSAccordionItem | nil | Active item |

==== TWvdSAccordionItem ====

| Property | Type | Description |
^ Header | string | Header text |
^ Content | TWvdSFrameworkElement | Content |
^ IsExpanded | Boolean | Expanded |
^ Icon | TWvdSImageSource | Icon |

----

===== TWvdSBreadcrumb =====

Breadcrumb navigation.

==== Namespace ====

''WvdS.UI.Controls.Navigation''

==== PXAML ====

<code xml>
<Breadcrumb Path="{Binding CurrentPath}"
            Separator=">"
            OnPathChanged="OnNavigate" />
</code>

==== Properties ====

| Property | Type | Default | Description |
^ Path | string | '' | Current path |
^ Items | TWvdSBreadcrumbItemCollection | nil | Path elements |
^ Separator | string | '/' | Separator |
^ IsEditable | Boolean | False | Path editable |

==== Events ====

| Event | Signature | Description |
^ OnPathChanged | TPathChangedEvent | Path changed |
^ OnItemClick | TItemClickEvent | Item clicked |

----

===== TWvdSPager =====

Page navigation for lists.

==== Namespace ====

''WvdS.UI.Controls.Navigation''

==== PXAML ====

<code xml>
<Pager CurrentPage="{Binding CurrentPage}"
       TotalPages="{Binding TotalPages}"
       PageSize="25" />
</code>

==== Properties ====

| Property | Type | Default | Description |
^ CurrentPage | Integer | 1 | Current page |
^ TotalPages | Integer | 1 | Total pages |
^ PageSize | Integer | 10 | Items per page |
^ TotalItems | Integer | 0 | Total items |
^ DisplayMode | TWvdSPagerMode | pmNumeric | Numeric, NextPrev, Full |

==== Events ====

| Event | Signature | Description |
^ OnPageChanged | TPageChangedEvent | Page changed |

----

===== TWvdSWizard =====

Step-by-step assistant.

==== Namespace ====

''WvdS.UI.Controls.Navigation''

==== PXAML ====

<code xml>
<Wizard SelectedPageIndex="{Binding CurrentStep}"
        OnFinish="OnWizardComplete">
  <WizardPage Title="Welcome" CanNext="True">
    <WelcomeContent />
  </WizardPage>
  <WizardPage Title="Configuration" CanBack="True" CanNext="{Binding IsValid}">
    <ConfigContent />
  </WizardPage>
  <WizardPage Title="Finish" CanBack="True" CanFinish="True">
    <SummaryContent />
  </WizardPage>
</Wizard>
</code>

==== Properties ====

| Property | Type | Default | Description |
^ Pages | TWvdSWizardPageCollection | nil | Wizard pages |
^ SelectedPageIndex | Integer | 0 | Active page |
^ SelectedPage | TWvdSWizardPage | nil | Active page |
^ ShowNavigationButtons | Boolean | True | Show nav buttons |
^ CanCancel | Boolean | True | Cancel possible |

==== Events ====

| Event | Signature | Description |
^ OnPageChanging | TPageChangingEvent | Before page change |
^ OnFinish | TNotifyEvent | Wizard completed |
^ OnCancel | TNotifyEvent | Wizard cancelled |

==== TWvdSWizardPage ====

| Property | Type | Description |
^ Title | string | Page title |
^ Description | string | Description |
^ Content | TWvdSFrameworkElement | Content |
^ CanBack | Boolean | Back possible |
^ CanNext | Boolean | Next possible |
^ CanFinish | Boolean | Finish possible |

----

===== TWvdSNavBar =====

Vertical navigation bar.

==== Namespace ====

''WvdS.UI.Controls.Navigation''

==== PXAML ====

<code xml>
<NavBar SelectedItem="{Binding SelectedMenu}">
  <NavBarGroup Header="Main">
    <NavBarItem Caption="Dashboard" Icon="home" />
    <NavBarItem Caption="Orders" Icon="list" />
  </NavBarGroup>
  <NavBarGroup Header="Settings">
    <NavBarItem Caption="Preferences" Icon="settings" />
  </NavBarGroup>
</NavBar>
</code>

==== Properties ====

| Property | Type | Default | Description |
^ Groups | TWvdSNavBarGroupCollection | nil | Groups |
^ SelectedItem | TWvdSNavBarItem | nil | Selected item |
^ IsCollapsed | Boolean | False | Collapsed |
^ CollapsedWidth | Integer | 50 | Width when collapsed |
^ ExpandedWidth | Integer | 200 | Width when expanded |

==== Events ====

| Event | Signature | Description |
^ OnItemSelected | TItemSelectedEvent | Item selected |

----

===== TWvdSTileControl =====

Tile-based navigation (Metro style).

==== Namespace ====

''WvdS.UI.Controls.Navigation''

==== PXAML ====

<code xml>
<TileControl>
  <TileGroup Header="Applications">
    <Tile Caption="Mail" Icon="mail" Size="Large"
          Background="Blue" Command="{Binding OpenMail}" />
    <Tile Caption="Calendar" Icon="calendar" Size="Normal" />
    <Tile Caption="Tasks" Icon="check" Size="Small" />
  </TileGroup>
</TileControl>
</code>

==== Properties ====

| Property | Type | Default | Description |
^ Groups | TWvdSTileGroupCollection | nil | Tile groups |
^ ItemSize | TWvdSTileSize | tsNormal | Default size |
^ Orientation | TWvdSOrientation | oHorizontal | Arrangement |

==== TWvdSTile ====

| Property | Type | Description |
^ Caption | string | Title |
^ Icon | TWvdSImageSource | Icon |
^ Size | TWvdSTileSize | Small, Normal, Wide, Large |
^ Background | TWvdSBrush | Background |
^ Command | IWvdSCommand | Click command |
^ Badge | string | Badge text |

----

===== See Also =====

  * [[.:control-bibliothek|Control Library]]
  * [[.:api-controls-basic|Basic Controls API]]
  * [[.:api-controls-bars|Bars/Ribbon API]]