====== API: Specialized Controls ======

API Reference for specialized components.

===== TWvdSScheduler =====

Calendar and appointment scheduling.

==== Namespace ====

''WvdS.UI.Controls.Specialized''

==== PXAML ====

<code xml>
<Scheduler DataSource="{Binding Appointments}"
           StartProperty="Start"
           EndProperty="End"
           SubjectProperty="Subject"
           CurrentDate="{Binding SelectedDate}"
           ViewType="Week">
  <Scheduler.Resources>
    <SchedulerResource Id="1" Caption="Room A" Color="Blue" />
    <SchedulerResource Id="2" Caption="Room B" Color="Green" />
  </Scheduler.Resources>
</Scheduler>
</code>

==== Properties ====

| Property | Type | Default | Description |
^ DataSource | IEnumerable | nil | Appointment data |
^ StartProperty | string | 'Start' | Start field |
^ EndProperty | string | 'End' | End field |
^ SubjectProperty | string | 'Subject' | Subject field |
^ CurrentDate | TDateTime | Today | Active date |
^ ViewType | TSchedulerViewType | svDay | Day, Week, Month, Timeline |
^ Resources | TResourceCollection | nil | Resources |
^ FirstDayOfWeek | TDayOfWeek | dwMonday | Week start |
^ WorkTimeStart | TTime | 08:00 | Work start |
^ WorkTimeEnd | TTime | 18:00 | Work end |

==== Events ====

| Event | Signature | Description |
^ OnAppointmentClick | TAppointmentEvent | Appointment clicked |
^ OnAppointmentEditing | TAppointmentEditEvent | Appointment editing |
^ OnDateChanged | TDateChangedEvent | Date changed |

----

===== TWvdSRichEditControl =====

Word processor control.

==== Namespace ====

''WvdS.UI.Controls.Specialized''

==== PXAML ====

<code xml>
<RichEditControl Document="{Binding DocumentContent}"
                 DocumentFormat="OpenXml"
                 ShowRuler="True"
                 ShowStatusBar="True" />
</code>

==== Properties ====

| Property | Type | Default | Description |
^ Document | TWvdSDocument | nil | Document |
^ DocumentFormat | TDocumentFormat | dfRtf | Rtf, OpenXml, Html, PlainText |
^ ShowRuler | Boolean | True | Show ruler |
^ ShowStatusBar | Boolean | True | Status bar |
^ ReadOnly | Boolean | False | Read-only |
^ SpellCheckEnabled | Boolean | True | Spell check |

==== Methods ====

| Method | Description |
^ LoadDocument(path) | Load document |
^ SaveDocument(path, format) | Save document |
^ Print | Print |
^ ExportToPdf(path) | Export as PDF |

----

===== TWvdSSpreadsheetControl =====

Spreadsheet.

==== Namespace ====

''WvdS.UI.Controls.Specialized''

==== PXAML ====

<code xml>
<SpreadsheetControl Document="{Binding Workbook}"
                    ActiveSheet="{Binding CurrentSheet}"
                    ShowFormulaBar="True" />
</code>

==== Properties ====

| Property | Type | Default | Description |
^ Document | TWvdSWorkbook | nil | Workbook |
^ ActiveSheet | TWvdSWorksheet | nil | Active sheet |
^ ShowFormulaBar | Boolean | True | Formula bar |
^ ShowSheetTabs | Boolean | True | Sheet tabs |
^ ReadOnly | Boolean | False | Read-only |

==== Methods ====

| Method | Description |
^ LoadDocument(path) | Load Excel file |
^ SaveDocument(path) | Save |
^ ExportToPdf(path) | As PDF |
^ Calculate | Calculate formulas |

----

===== TWvdSMapControl =====

Map display.

==== Namespace ====

''WvdS.UI.Controls.Specialized''

==== PXAML ====

<code xml>
<MapControl CenterPoint="{Binding MapCenter}"
            ZoomLevel="{Binding Zoom}"
            MapProvider="OpenStreetMap">
  <MapControl.Layers>
    <VectorLayer ItemsSource="{Binding Markers}">
      <VectorLayer.ItemTemplate>
        <MapPushpin Location="{Binding Location}"
                    Text="{Binding Name}" />
      </VectorLayer.ItemTemplate>
    </VectorLayer>
  </MapControl.Layers>
</MapControl>
</code>

==== Properties ====

| Property | Type | Default | Description |
^ CenterPoint | TGeoPoint | (0,0) | Map center |
^ ZoomLevel | Double | 10 | Zoom level |
^ MapProvider | TMapProvider | mpOpenStreetMap | OpenStreetMap, Bing, etc. |
^ Layers | TMapLayerCollection | nil | Map layers |
^ ShowMiniMap | Boolean | False | Mini map |
^ ShowScale | Boolean | True | Scale |

----

===== TWvdSDiagramControl =====

Diagram editor.

==== Namespace ====

''WvdS.UI.Controls.Specialized''

==== PXAML ====

<code xml>
<DiagramControl Document="{Binding DiagramDocument}"
                Shapes="{Binding AvailableShapes}"
                Connectors="{Binding Connections}">
  <DiagramControl.Toolbox>
    <DiagramToolbox>
      <ToolboxGroup Header="Basic Shapes">
        <ToolboxShape ShapeType="Rectangle" />
        <ToolboxShape ShapeType="Ellipse" />
        <ToolboxShape ShapeType="Diamond" />
      </ToolboxGroup>
    </DiagramToolbox>
  </DiagramControl.Toolbox>
</DiagramControl>
</code>

==== Properties ====

| Property | Type | Default | Description |
^ Document | TDiagramDocument | nil | Diagram |
^ Shapes | TDiagramShapeCollection | nil | Shapes |
^ Connectors | TConnectorCollection | nil | Connectors |
^ ShowGrid | Boolean | True | Show grid |
^ SnapToGrid | Boolean | True | Snap to grid |

----

===== TWvdSPdfViewer =====

PDF viewer.

==== Namespace ====

''WvdS.UI.Controls.Specialized''

==== PXAML ====

<code xml>
<PdfViewer DocumentSource="{Binding PdfPath}"
           CurrentPage="{Binding CurrentPage}"
           ZoomMode="FitWidth" />
</code>

==== Properties ====

| Property | Type | Default | Description |
^ DocumentSource | string | '' | PDF path or stream |
^ CurrentPage | Integer | 1 | Current page |
^ PageCount | Integer | 0 | Page count (read-only) |
^ ZoomLevel | Double | 100 | Zoom in % |
^ ZoomMode | TZoomMode | zmActualSize | ActualSize, FitWidth, FitPage |
^ ShowToolbar | Boolean | True | Toolbar |
^ ShowThumbnails | Boolean | False | Page preview |

==== Methods ====

| Method | Description |
^ Print | Print |
^ GoToPage(n) | Go to page |
^ Search(text) | Search text |

----

===== TWvdSImageGallery =====

Image gallery.

==== Namespace ====

''WvdS.UI.Controls.Specialized''

==== PXAML ====

<code xml>
<ImageGallery ItemsSource="{Binding Images}"
              ImageMember="Url"
              ThumbnailMember="Thumbnail"
              CaptionMember="Title"
              ViewMode="Thumbnails" />
</code>

==== Properties ====

| Property | Type | Default | Description |
^ ItemsSource | IEnumerable | nil | Image data |
^ ImageMember | string | '' | Image URL field |
^ ThumbnailMember | string | '' | Thumbnail field |
^ CaptionMember | string | '' | Title field |
^ SelectedImage | TObject | nil | Selected image |
^ ViewMode | TGalleryViewMode | gvThumbnails | Thumbnails, Slideshow |
^ ThumbnailSize | Integer | 100 | Thumbnail size |

----

===== TWvdSSpellChecker =====

Spell checker.

==== Namespace ====

''WvdS.UI.Controls.Specialized''

==== Syntax ====

<code pascal>
SpellChecker := TWvdSSpellChecker.Create;
SpellChecker.Dictionary := 'en-US';
SpellChecker.CheckControl(MemoEdit);
</code>

==== Properties ====

| Property | Type | Default | Description |
^ Dictionary | string | 'en-US' | Dictionary |
^ CustomDictionary | TStrings | nil | Custom words |
^ IgnoreUppercase | Boolean | True | Ignore uppercase |
^ IgnoreNumbers | Boolean | True | Ignore numbers |

==== Methods ====

| Method | Description |
^ Check(text) | Check text |
^ GetSuggestions(word) | Get suggestions |
^ AddToCustom(word) | Add to dictionary |

----

===== TWvdSFilterControl =====

Filter builder for data.

==== Namespace ====

''WvdS.UI.Controls.Specialized''

==== PXAML ====

<code xml>
<FilterControl DataSource="{Binding DataGrid.DataSource}"
               FilterExpression="{Binding Filter, Mode=TwoWay}" />
</code>

==== Properties ====

| Property | Type | Default | Description |
^ DataSource | IEnumerable | nil | Data source |
^ FilterExpression | string | '' | Filter expression |
^ AvailableFields | TStringList | nil | Available fields |

----

===== TWvdSExpressionEditor =====

Formula editor.

==== Namespace ====

''WvdS.UI.Controls.Specialized''

==== PXAML ====

<code xml>
<ExpressionEditor Expression="{Binding Formula}"
                  DataSource="{Binding AvailableFields}"
                  ShowFunctions="True" />
</code>

==== Properties ====

| Property | Type | Default | Description |
^ Expression | string | '' | Formula |
^ DataSource | IEnumerable | nil | Available fields |
^ ShowFunctions | Boolean | True | Functions panel |
^ ValidatedExpression | string | '' | Validated formula |

----

===== TWvdSPropertyGridControl =====

Property grid for object editing.

==== Namespace ====

''WvdS.UI.Controls.Specialized''

==== PXAML ====

<code xml>
<PropertyGridControl SelectedObject="{Binding SelectedItem}"
                     ShowCategories="True"
                     SortMode="Categorized" />
</code>

==== Properties ====

| Property | Type | Default | Description |
^ SelectedObject | TObject | nil | Edited object |
^ SelectedObjects | TObjectList | nil | Multiple objects |
^ ShowCategories | Boolean | True | Show categories |
^ SortMode | TSortMode | smCategorized | Alphabetical, Categorized |

----

===== TWvdSSearchControl =====

Search input field.

==== Namespace ====

''WvdS.UI.Controls.Specialized''

==== PXAML ====

<code xml>
<SearchControl SearchText="{Binding Query}"
               Placeholder="Search..."
               ShowClearButton="True"
               SearchMode="Instant" />
</code>

==== Properties ====

| Property | Type | Default | Description |
^ SearchText | string | '' | Search text |
^ Placeholder | string | '' | Placeholder |
^ SearchMode | TSearchMode | smInstant | Instant, OnEnter |
^ MinSearchLength | Integer | 1 | Min characters |

==== Events ====

| Event | Signature | Description |
^ OnSearch | TSearchEvent | Search triggered |

----

===== TWvdSRangeControl =====

Range selection for time series.

==== Namespace ====

''WvdS.UI.Controls.Specialized''

==== PXAML ====

<code xml>
<RangeControl DataSource="{Binding TimeData}"
              ArgumentMember="Date"
              ValueMember="Value"
              SelectionStart="{Binding RangeStart}"
              SelectionEnd="{Binding RangeEnd}" />
</code>

==== Properties ====

| Property | Type | Default | Description |
^ DataSource | IEnumerable | nil | Data source |
^ SelectionStart | TDateTime | 0 | Range start |
^ SelectionEnd | TDateTime | 0 | Range end |

----

===== TWvdSZoomTrackBar =====

Zoom slider.

==== Namespace ====

''WvdS.UI.Controls.Specialized''

==== PXAML ====

<code xml>
<ZoomTrackBar Value="{Binding ZoomLevel}"
              Minimum="25" Maximum="400"
              DefaultValue="100"
              ShowButtons="True" />
</code>

==== Properties ====

| Property | Type | Default | Description |
^ Value | Integer | 100 | Zoom in % |
^ Minimum | Integer | 25 | Minimum |
^ Maximum | Integer | 400 | Maximum |
^ DefaultValue | Integer | 100 | Default (double-click) |
^ ShowButtons | Boolean | True | +/- buttons |

----

===== TWvdSMarkupEdit =====

Markup/Markdown editor.

==== Namespace ====

''WvdS.UI.Controls.Specialized''

==== PXAML ====

<code xml>
<MarkupEdit Text="{Binding MarkdownContent}"
            MarkupType="Markdown"
            ShowPreview="True"
            PreviewPosition="Right" />
</code>

==== Properties ====

| Property | Type | Default | Description |
^ Text | string | '' | Markup text |
^ MarkupType | TMarkupType | mtMarkdown | Markdown, Html, BBCode |
^ ShowPreview | Boolean | True | Show preview |
^ PreviewPosition | TPosition | pRight | Right, Bottom |

----

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

  * [[.:control-bibliothek|Control Library]]
  * [[.:api-controls-data|Data Controls API]]
  * [[.:api-controls-editors|Editor Controls API]]