Wt C++ Web Toolkit Documentation

https://www.webtoolkit.eu/wt/documentation
Admin
Wt is a C++ Web Toolkit that enables developers to create web applications using C++. It provides a...
Tokens:7,864
Snippets:10
Trust Score:9.9
Update:1 year ago
Show doc for...
Tokens:
Raw
### Wt Installation and Download

Source: https://www.webtoolkit.eu/wt/documentation/examples/mail-composer

Information on installing Wt across different platforms and links to download the source code or prebuilt binaries.

```en
[Wt installation instructions for various platforms (Linux, Windows, OS X, ...)](http://redmine.webtoolkit.eu/projects/wt/wiki/Wt_Installation)
[Download the source code](../../../wt/download)
[Prebuilt binaries for Windows](https://github.com/emweb/wt/releases)
```

--------------------------------

### Wt Example Navigation

Source: https://www.webtoolkit.eu/wt/documentation/examples/mail-composer

Provides links to various Wt examples, categorized by functionality, allowing users to explore different features and their implementations.

```en
* [Hello world!](../../../wt/documentation/examples/)
* [Charts](../../../wt/documentation/examples/charts)
* [Treeview](../../../wt/documentation/examples/treeview)
* [Git explorer](../../../wt/documentation/examples/git)
* [Simple chat](../../../wt/documentation/examples/chat)
* [Mail composer](../../../wt/documentation/examples/mail-composer)
* [Hangman](../../../wt/documentation/examples/hangman)
```

--------------------------------

### Hangman Example Implementation Details

Source: https://www.webtoolkit.eu/wt/documentation/examples/hangman

Details on the Hangman example's implementation, highlighting specific Wt features used for layout, content optimization, navigation, authentication, and database interaction.

```APIDOC
Wt::WTemplate
  - Used for layout management in the Hangman example.

Wt::WBoxLayout
  - Another layout manager option illustrated in the example.

WAnchor
  - Used for navigation by referencing internal paths and reacting to path changes.

Wt::Auth
  - The authentication module used for user login via username/password or Google OAuth 2.0.

Wt::Dbo
  - Used for database access and persistence of user information, as demonstrated in the Hangman game's ranking system.
```

--------------------------------

### Mail Composer Example Overview

Source: https://www.webtoolkit.eu/wt/documentation/examples/mail-composer

Details the Wt Mail Composer example, highlighting asynchronous file uploads, progress bars, and advanced widget interactions. It mentions specific Wt classes like WSuggestionPopup, WFileUpload, and WProgressBar.

```en
This example implements a GMail-like mail composer and shows among other things how to upload files asynchronously, showing a cross-browser upload progress bar and with support for multiple files.

* The *ContactSuggestions* class provides auto-completion of the addressees in the To: Cc: and Bcc: fields. The widget derives from [WSuggestionPopup](//www.webtoolkit.eu/wt/doc/reference/html/classWt_1_1WSuggestionPopup.html).
* The *AttachmentEdit* widget uses a [WFileUpload](//www.webtoolkit.eu/wt/doc/reference/html/classWt_1_1WFileUpload.html) to asynchronously upload files. The upload [progress bar](//www.webtoolkit.eu/wt/doc/reference/html/classWt_1_1WProgressBar.html) will work even in IE6.
* The *Option* and *OptionList* classes show how stateless slots, a trick to handle events client-side but implement them still in C++, may be used even when the behaviour is not entirely stateless. In this case, the hiding of an Option affects neighboring visible options: an option needs a separator only if there is a neighbouring option. By **invalidating the stateless slot implementations** when state has changed, we can still use a stateless slot implementation and enjoy client-side event handling performance!
```

--------------------------------

### Wt Treeview Drag and Drop Example

Source: https://www.webtoolkit.eu/wt/documentation/examples/treeview

An example demonstrating MVC functionality using Wt widgets, specifically focusing on drag and drop capabilities within tree and table views. It showcases the use of WTreeView, WTableView, and WSortFilterProxyModel.

```cpp
// Example demonstrating Wt's MVC functionality with drag and drop
// Uses WTreeView, WTableView, WSortFilterProxyModel
// For full source code, refer to the Wt examples directory.
```

--------------------------------

### Wt Library Documentation Links

Source: https://www.webtoolkit.eu/wt/documentation/examples/mail-composer

Provides links to essential Wt library documentation resources, including the main reference manual, specific tutorials, and the widget gallery for practical examples.

```en
[Wt library overview](https://www.webtoolkit.eu/wt/doc/reference/html/overview.html)
[Introduction to Wt](https://www.webtoolkit.eu/wt/doc/tutorial/wt.html)
[Introduction to Wt::Dbo](https://www.webtoolkit.eu/wt/doc/tutorial/dbo.html)
[Introduction to Wt::Auth](https://www.webtoolkit.eu/wt/doc/tutorial/auth.html)
[Wt 4 reference](https://www.webtoolkit.eu/wt/doc/reference/html/)
[Wt 3 reference](https://www.webtoolkit.eu/wt/wt3/doc/reference/html/)
[Widget gallery](https://www.webtoolkit.eu/widgets)
```

--------------------------------

### Wt Community and Support Resources

Source: https://www.webtoolkit.eu/wt/documentation/examples/mail-composer

Lists key community and support resources for Wt users, including forums, issue tracking, wiki, and the project's GitHub repository.

```en
[Redmine](http://redmine.webtoolkit.eu/projects/wt)
[forums](http://redmine.webtoolkit.eu/projects/wt/boards)
[issues](http://redmine.webtoolkit.eu/projects/wt/issues)
[wiki](http://redmine.webtoolkit.eu/projects/wt/wiki)
[GitHub](https://github.com/emweb/wt)
```

--------------------------------

### Wt MVC Views and Models Documentation

Source: https://www.webtoolkit.eu/wt/documentation/examples/treeview

Details on Wt's Model-View-Controller (MVC) components, including tree and table views, proxy models for sorting/filtering, and layout management. These components facilitate data rendering and interaction within Wt applications.

```APIDOC
Wt MVC Views and Models:

- WTreeView:
  - Description: Widget for rendering a Model's data in a tree structure.
  - Usage: Displays hierarchical data.
  - Related: WTableView, WSortFilterProxyModel.

- WTableView:
  - Description: Widget for rendering a Model's data in a table structure.
  - Usage: Displays tabular data.
  - Related: WTreeView, WSortFilterProxyModel.

- WSortFilterProxyModel:
  - Description: Implements sorting and filtering for another model.
  - Usage: Enhances data models with sorting and filtering capabilities.
  - Related: WTreeView, WTableView.

- WBoxLayout:
  - Description: Nested layout managers (horizontal and vertical) for automatic window-filling layout with optional resize handles.
  - Usage: Manages widget positioning and resizing within layouts.
  - Related: Other layout managers.

- WDialog:
  - Description: Supports modal and non-modal dialogs for prompting user input.
  - Usage: Creates pop-up windows for user interaction.
  - Related: WPopupMenu.

- WPopupMenu:
  - Description: Displays a context-sensitive menu.
  - Usage: Provides options based on user context.
  - Related: WDialog.
```

--------------------------------

### Wt Charting Widgets and Painting API

Source: https://www.webtoolkit.eu/wt/documentation/examples/charts

Demonstrates Wt's charting widgets built on its cross-browser painting API. This API uses browser features like VML, SVG, HTML5 canvas, or PNG for rendering within WPaintedWidget. It also shows how to share Models across multiple Views, like a table view and a chart, which both act as Views on the same item model.

```APIDOC
Wt Charting Widgets and Painting API:
  Purpose: Showcase charting widgets and cross-browser painting API.
  Dependencies: Wt charting widgets, Wt painting API, WPaintedWidget, WTableView, WAbstractItemModel.
  Features:
    - Implements charting widgets on Wt's cross-browser painting API.
    - Painting API uses VML, SVG, HTML5 canvas, or PNG based on browser support.
    - Renders painted contents in WPaintedWidget.
    - Demonstrates Model-View architecture: sharing a Model between multiple Views (e.g., table and chart).
  Related Classes:
    - Wt::WPaintedWidget
    - Wt::WTableView
    - Wt::WAbstractItemModel
  Example Usage:
    - Run example: //www.webtoolkit.eu/wt/examples/charts/charts.wt
    - Browse source code: ../../../wt/src/charts
```

--------------------------------

### Embed Simple Chat Widget in HTML

Source: https://www.webtoolkit.eu/wt/documentation/examples/chat

This snippet shows how to embed the SimpleChat Wt widget into an existing HTML page. It uses a script tag to load the chat functionality, which communicates with the server via Cross-Origin Ajax/WebSocket requests. The 'div' parameter specifies the target HTML element for the widget.

```HTML
<div id="chat"></div>
<script src="//www.webtoolkit.eu/wt/examples/simplechat/chat.js?div=chat"></script>
```
Tokens:
Raw