NoesisGUI

https://www.noesisengine.com/docs/
Admin
NoesisGUI is a multiplatform graphical user interface middleware for realtime applications that uses...
Tokens:793,808
Snippets:6,985
Trust Score:9.1
Update:5 months ago
Show doc for...
Tokens:
Raw
### Setup LocExtension in XAML

Source: https://www.noesisengine.com/docs/App.ApplicationLauncher._LocExtension.html

This example demonstrates the full setup for a LocExtension in XAML, including referencing a ResourceDictionary via the Loc.Source attached property and using the extension for Image and TextBlock elements. It also shows how to use RichText.Text with BBCode markup and apply a converter.

```xaml
<StackPanel
  xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
  xmlns:noesis="clr-namespace:NoesisGUIExtensions"
  noesis:Loc.Source="Language_en-gb.xaml">
  <Image Source="{noesis:Loc Flag}"/>
  <TextBlock noesis:RichText.Text="{noesis:Loc SoundLabel}"/>
  <TextBlock noesis:RichText.Text="{noesis:Loc TitleLabel, Converter={StaticResource CaseConverter}, ConverterParameter=UpperCase}"/>
</StackPanel>
```

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

### Example Usage

Source: https://www.noesisengine.com/docs/Gui.Core._ContextMenuService.html

This example demonstrates how to use the ContextMenuService to display a ContextMenu on a disabled button by setting the ShowOnDisabled property.

```APIDOC
## Example Usage

```xaml
<Button Height="30" Content="Disabled Button" IsEnabled="False"
     ContextMenuService.ShowOnDisabled="True">
  <Button.ContextMenu>
    <ContextMenu>
      <MenuItem Header="Item 1"/>
      <MenuItem Header="Item 2"/>
      <MenuItem Header="Item 3"/>
    </ContextMenu>
  </Button.ContextMenu>
</Button>
```
```

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

### KeyBinding XAML Example

Source: https://www.noesisengine.com/docs/Gui.Core._KeyBinding.html

Example of how to define a KeyBinding in XAML to associate a keyboard shortcut with a command.

```APIDOC
## KeyBinding XAML Example

### Description
This example demonstrates how to use the `KeyBinding` element in XAML to bind a keyboard gesture to a command. The `Gesture` attribute specifies the key combination (e.g., "Ctrl+O"), and the `Command` attribute specifies the command to be executed (e.g., `ApplicationCommands.Open`).

### Method
Not applicable (XAML declaration)

### Endpoint
Not applicable (XAML declaration)

### Parameters
#### Path Parameters
None

#### Query Parameters
None

#### Request Body
None

### Request Example
```xaml
<Grid
  xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation">
  <Grid.InputBindings>
    <KeyBinding Gesture="Ctrl+O" Command="ApplicationCommands.Open"/>
  </Grid.InputBindings>
</Grid>
```

### Response
#### Success Response (200)
Not applicable (XAML declaration)

#### Response Example
Not applicable (XAML declaration)
```

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

### KeyTrigger Example Usage

Source: https://www.noesisengine.com/docs/App.Interactivity._KeyTrigger.html

An example demonstrating how to use the KeyTrigger in XAML to invoke a command when a specific key is pressed.

```APIDOC
## KeyTrigger Example

```xml
<UserControl
  xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
  xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
  xmlns:b="http://schemas.microsoft.com/xaml/behaviors">
  <b:Interaction.Triggers>
    <b:KeyTrigger FiredOn="KeyDown" Key="Escape">
      <b:InvokeCommandAction Command="{Binding ExitCommand}" />
    </b:KeyTrigger>
  </b:Interaction.Triggers>
  ...
</UserControl>
```
```

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

### Absolute URI Examples

Source: https://www.noesisengine.com/docs/Gui.Providers._Uri.html

Demonstrates various forms of absolute URIs supported by NoesisGUI, including pack, file, and HTTP schemes, as well as paths starting with drive letters.

```xml
<Image Source="pack://application:,,,/Images/icon.png" />
```

```xml
<Image Source="file:///Images/icon.png" />
```

```xml
<Image Source="C:/Images/icon.png" />
```

```xml
<Image Source="http://www.noesisengine.com" />
```

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

### LinearGradientBrush Example

Source: https://www.noesisengine.com/docs/Gui.Core._LinearGradientBrush.html

An example demonstrating how to use LinearGradientBrush to fill a Rectangle with a gradient from blue to red.

```APIDOC
## Example
```xaml
<Page xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation">
  <Rectangle Width="200" Height="100">
    <Rectangle.Fill>
      <LinearGradientBrush StartPoint="0,0" EndPoint="1,1">
        <GradientStop Color="Blue" Offset="0"/>
        <GradientStop Color="Red" Offset="1.0"/>
      </LinearGradientBrush>
    </Rectangle.Fill>
  </Rectangle>
</Page>
```
```

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

### Relative URI Example

Source: https://www.noesisengine.com/docs/Gui.Providers._Uri.html

Shows a basic example of a relative URI, which consists only of the path and is resolved relative to the current XAML file's location by default.

```xml
<Image Source="Images/icon.png" />
```

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

### Install Scheme-Specific XAML Provider

Source: https://www.noesisengine.com/docs/Gui.Core.ProvidersTutorial.html

Install a XAML provider that handles all URIs using a specific scheme, like 'noesis:///MainWindow.xaml'.

```cpp
// This will handle uris like 'noesis:///MainWindow.xaml'
Noesis::GUI::SetSchemeXamlProvider("noesis", xamlProvider);
```

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

### Install Scheme and Assembly XAML Provider

Source: https://www.noesisengine.com/docs/Gui.Core.ProvidersTutorial.html

Install a XAML provider that handles URIs with both a specific scheme and assembly name, like 'noesis:///MyExtensions;component/MainWindow.xaml'.

```cpp
/// This will handle uris like 'noesis:///MyExtensions;component/MainWindow.xaml'
Noesis::GUI::SetSchemeAssemblyXamlProvider("noesis", "MyExtensions", xamlProvider);
```

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

### Application Resource Dictionary Example

Source: https://www.noesisengine.com/docs/Gui.Core.StylingTutorial.html

An example of an Application resource dictionary in XAML. This dictionary merges a theme file and defines custom brushes for application-level styling.

```xaml
<Application
  xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
  xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
  x:Class="XamlPlayer.App"
  StartupUri="MainWindow.xaml">
  <Application.Resources>
    <ResourceDictionary>
      <ResourceDictionary.MergedDictionaries>
        <ResourceDictionary Source="Theme/NoesisTheme.DarkBlue.xaml"/>
      </ResourceDictionary.MergedDictionaries>
      <!-- Resources scoped at the Application level should be defined here. -->
      <SolidColorBrush x:Key="Background0" Color="#FF2F3F4F"/>
      <SolidColorBrush x:Key="Background1" Color="SlateGray"/>
      <SolidColorBrush x:Key="Foreground0" Color="White"/>
      <SolidColorBrush x:Key="Foreground1" Color="SkyBlue"/>
      <SolidColorBrush x:Key="Foreground2" Color="Black"/>
      <SolidColorBrush x:Key="Border" Color="LightSlateGray"/>
    </ResourceDictionary>
  </Application.Resources>
</Application>
```

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

### Install Assembly-Specific XAML Provider

Source: https://www.noesisengine.com/docs/Gui.Core.ProvidersTutorial.html

Install a XAML provider that handles URIs containing a specific assembly name, such as '/MyExtensions;component/MainWindow.xaml'.

```cpp
// This will handle uris like '/MyExtensions;component/MainWindow.xaml'
Noesis::GUI::SetAssemblyXamlProvider("MyExtensions", xamlProvider);
```

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

### MouseBinding XAML Example

Source: https://www.noesisengine.com/docs/Gui.Core._MouseBinding.html

This example demonstrates how to define a MouseBinding in XAML to associate a mouse gesture with a command.

```APIDOC
## MouseBinding XAML Example

### Description
This example shows how to use the `MouseBinding` class in XAML to bind a mouse gesture, such as 'Ctrl+MiddleClick', to a command.

### Usage
```xaml
<Grid
  xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation">
  <Grid.InputBindings>
    <MouseBinding Gesture="Ctrl+MiddleClick" Command="{Binding MiddleClickCommand}"/>
  </Grid.InputBindings>
</Grid>
```

### Parameters
- **Gesture** (string) - Required - Specifies the mouse gesture (e.g., 'CTRL+LeftClick').
- **Command** (ICommand) - Required - The command to be executed when the gesture is detected.
```

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

### Install Global Resource Providers

Source: https://www.noesisengine.com/docs/Gui.Core.ProvidersTutorial.html

After initializing Noesis, install the global providers for XAML, Texture, and Font resources. These handle requests not resolved by more specific providers.

```cpp
Noesis::GUI::Init();

// Install global providers
Noesis::GUI::SetXamlProvider(xamlProvider);
Noesis::GUI::SetTextureProvider(textureProvider);
Noesis::GUI::SetFontProvider(fontProvider);
```

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

### RiveRun Usage Example

Source: https://www.noesisengine.com/docs/App.RiveBase._RiveRun.html

Example demonstrating how to use the RiveRun class within XAML to bind text runs to data context properties.

```APIDOC
## RiveRun Usage Example

### Description
Example demonstrating how to use the RiveRun class within XAML to bind text runs to data context properties.

### XAML
```xml
<noesis:RiveControl Source="player.riv">
  <noesis:RiveControl.Runs>
    <noesis:RiveRun RunName="PlayerName" RunText="{Binding Player.Name}"/>
    <noesis:RiveRun RunPath="DetailsArtboard" RunName="Age" RunText="{Binding Player.Age}"/>
  </noesis:RiveControl.Runs>
</noesis:RiveControl>
```
```

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

### AppStarting Cursor

Source: https://www.noesisengine.com/docs/Gui.Core._Cursors.html

Gets the Cursor that appears when an application is starting.

```APIDOC
## Property: AppStarting

### Description
Gets the Cursor that appears when an application is starting.

### Type
Cursor
```

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

### ThicknessAnimation Methods

Source: https://www.noesisengine.com/docs/Gui.Animation._ThicknessAnimation.html

Methods available for ThicknessAnimation, including getting the current animated value and starting the animation.

```APIDOC
## Methods

### ThicknessAnimationBase Methods (Inherited)
- **_GetCurrentValue(defaultOrigin, defaultDestination, clock)_** (object) - Gets the current value of the animation.

### AnimationTimeline Methods (Inherited)
- **_CreateTransitionFrom(easing)_** (Timeline) - Returns a new timeline used as transition (used by VisualStateManager).
- **_GetCurrentValue(defaultOrigin, defaultDestination, clock)_** (object) - Calculates the current animated value depending on current clock state.
- **_Start(target, dp, timeManager, handoff)_** (Clock) - Begins the animation timeline creating a compatible clock.
```

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

### _Start

Source: https://www.noesisengine.com/docs/Gui.Animation._ColorAnimationBase.html

Begins the animation timeline, creating a compatible clock.

```APIDOC
## _Start(target, dp, timeManager, handoff)

### Description
Begins the animation timeline creating a compatible clock.

### Method
Inherited from AnimationTimeline
```

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

### Int32Animation Methods

Source: https://www.noesisengine.com/docs/Gui.Animation._Int32Animation.html

Methods available for the Int32Animation class, including getting the current animated value and starting the animation.

```APIDOC
## Methods

### Int32AnimationBase Methods (Inherited)
- **GetCurrentValue(defaultOrigin, defaultDestination, clock)** (Object) - Gets the current value of the animation.

### AnimationTimeline Methods (Inherited)
- **CreateTransitionFrom(easing)** (Timeline) - Returns a new timeline used as transition (used by VisualStateManager).
- **GetCurrentValue(defaultOrigin, defaultDestination, clock)** (Object) - Calculates the current animated value depending on current clock state.
- **Start(target, dp, timeManager, handoff)** (Clock) - Begins the animation timeline creating a compatible clock.
```

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

### Create and Initialize a NoesisGUI View

Source: https://www.noesisengine.com/docs/Gui.Core.SDKGuide.html

Load XAML, create a view, set its dimensions and render flags, and initialize the renderer with a render device. This must be done on the rendering thread if using a separate thread.

```cpp
Ptr<FrameworkElement> xaml = Noesis::GUI::LoadXaml<FrameworkElement>("Reflections.xaml");
Ptr<IView> view = Noesis::GUI::CreateView(xaml);
view->SetFlags(Noesis::RenderFlags_PPAA | Noesis::RenderFlags_LCD);
view->SetSize(1024, 768);
```

```cpp
Ptr<RenderDevice> device = NoesisApp::GLFactory::CreateDevice();
view->GetRenderer()->Init(device);
```

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

### Portable Application Entry Point

Source: https://www.noesisengine.com/docs/Gui.Core.ApplicationTutorial.html

Use NsMain as a portable entry point for applications, as std::main is not available on all platforms. Configure and run the AppLauncher here.

```cpp
int NsMain(int argc, char **argv)
{
    AppLauncher launcher;
    launcher.SetArguments(argc, argv);
    launcher.SetApplicationFile("App.xaml");
    return launcher.Run();
}

```

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

### Set Local Resource Providers

Source: https://www.noesisengine.com/docs/Gui.Core.SDKGuide.html

Install resource providers to load XAML, fonts, and textures from the local file system. The '.' indicates the current directory.

```cpp
Noesis::GUI::SetXamlProvider(MakePtr<LocalXamlProvider>("."));
Noesis::GUI::SetFontProvider(MakePtr<LocalFontProvider>("."));
Noesis::GUI::SetTextureProvider(MakePtr<LocalTextureProvider>("."));

```

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

### C++ Application Class Implementation

Source: https://www.noesisengine.com/docs/Gui.Core.ApplicationTutorial.html

Inherit from the Application base class to create a custom application implementation in C++. This example shows a basic setup for a C++ application.

```cpp
namespace RssReader
{
    class App final: public Application
    {
        NS_IMPLEMENT_INLINE_REFLECTION_(App, Application, "RssReader.App")
    };
}

```

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

### MainWindow C++ Component Setup

Source: https://www.noesisengine.com/docs/Gui.Core.BlendTutorial.html

Implement the MainWindow C++ component deriving from Window and set its TypeId. Connect event handlers defined in the XAML file using NS_CONNECT_EVENT and NS_CONNECT_ATTACHED_EVENT macros.

```cpp
namespace BlendTutorial
{

class MainWindow final: public Window
{
public:
    MainWindow()
    {
        InitializeComponent();
    }

private:
    void InitializeComponent()
    {
        Noesis::GUI::LoadComponent(this, "MainWindow.xaml");
    }

    bool ConnectEvent(BaseComponent* source, const char* event, const char* handler) override
    {
        NS_CONNECT_EVENT(Button, Click, AddButton_Click);
        NS_CONNECT_EVENT(Button, Click, RemoveButton_Click);
        NS_CONNECT_EVENT(Border, PreviewMouseLeftButtonDown, ContainerBorder_MouseDown);
        NS_CONNECT_ATTACHED_EVENT(ToggleButton, Checked, RadioButton_Checked);
        return false;
    }

    void AddButton_Click(BaseComponent*, const RoutedEventArgs&)
    {
    }

    void RemoveButton_Click(BaseComponent*, const RoutedEventArgs&)
    {
    }

    void ContainerBorder_MouseDown(BaseComponent*, const MouseButtonEventArgs&)
    {
    }

    void RadioButton_Checked(BaseComponent*, const RoutedEventArgs&)
    {
    }

    NS_IMPLEMENT_INLINE_REFLECTION(MainWindow, Window)
    {
        NsMeta<TypeId>("BlendTutorial.MainWindow");
    }
};

}
```

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

### Set Theme Resource Providers

Source: https://www.noesisengine.com/docs/Gui.Core.SDKGuide.html

Use the Application Framework helper to install theme-specific resource providers, set default fonts, and configure system fallback fonts.

```cpp
NoesisApp::SetThemeProviders();

```

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

### TextBlock Text Wrapping and Trimming

Source: https://www.noesisengine.com/docs/Gui.Core.TextTutorial.html

Illustrates how TextWrapping (NoWrap, Wrap, WrapWithOverflow) and TextTrimming (None, CharacterEllipsis, WordEllipsis) properties affect text display within a fixed layout. This example requires a specific grid setup to visualize the effects.

```XAML
<Grid
  xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
  xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
  Background="White" UseLayoutRounding="True"
  TextElement.Foreground="Black">

  <Grid HorizontalAlignment="Center" VerticalAlignment="Center">
    <Grid.RowDefinitions>
      <RowDefinition/>
      <RowDefinition/>
      <RowDefinition/>
      <RowDefinition/>
      <RowDefinition/>
      <RowDefinition/>
    </Grid.RowDefinitions>
    <Grid.ColumnDefinitions>
      <ColumnDefinition/>
      <ColumnDefinition/>
      <ColumnDefinition/>
      <ColumnDefinition/>
      <ColumnDefinition/>
      <ColumnDefinition/>
      <ColumnDefinition/>
      <ColumnDefinition/>
      <ColumnDefinition/>
      <ColumnDefinition/>
    </Grid.ColumnDefinitions>

    <TextBlock Grid.Row="2" Grid.Column="0" Text="Justify" TextAlignment="Right" FontWeight="Bold"
        VerticalAlignment="Center"/>
    <TextBlock Grid.Row="3" Grid.Column="0" Text="Left" TextAlignment="Right" FontWeight="Bold"
        VerticalAlignment="Center"/>
    <TextBlock Grid.Row="4" Grid.Column="0" Text="Center" TextAlignment="Right" FontWeight="Bold"
        VerticalAlignment="Center"/>
    <TextBlock Grid.Row="5" Grid.Column="0" Text="Right" TextAlignment="Right" FontWeight="Bold"
        VerticalAlignment="Center"/>

    <Border Grid.Row="0" Grid.Column="1" Grid.ColumnSpan="3" Background="LightGray" Margin="5,1" Padding="0,2">
      <TextBlock Text="NoWrap" TextAlignment="Center" FontWeight="Bold"/>
    </Border>
    <Border Grid.Row="0" Grid.Column="4" Grid.ColumnSpan="3" Background="LightGray" Margin="5,1" Padding="0,2">
      <TextBlock Text="Wrap" TextAlignment="Center" FontWeight="Bold"/>
    </Border>
    <Border Grid.Row="0" Grid.Column="7" Grid.ColumnSpan="3" Background="LightGray" Margin="5,1" Padding="0,2">
      <TextBlock Text="WrapWithOverflow" TextAlignment="Center" FontWeight="Bold"/>
    </Border>

    <TextBlock Grid.Row="1" Grid.Column="1" Text="NoTrimming" TextAlignment="Center" FontWeight="Bold"/>
    <TextBlock Grid.Row="1" Grid.Column="2" Text="CharTrimming" TextAlignment="Center" FontWeight="Bold"/>
    <TextBlock Grid.Row="1" Grid.Column="3" Text="WordTrimming" TextAlignment="Center" FontWeight="Bold"/>

    <TextBlock Grid.Row="1" Grid.Column="4" Text="NoTrimming" TextAlignment="Center" FontWeight="Bold"/>
    <TextBlock Grid.Row="1" Grid.Column="5" Text="CharTrimming" TextAlignment="Center" FontWeight="Bold"/>

```

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

### Get

Source: https://www.noesisengine.com/docs/Gui.Core._ObservableCollection.html

Gets the element at the specified index.

```APIDOC
## Get(index)

### Description
Gets the element at the specified index.

### Method
Get

### Parameters
#### Path Parameters
- **index** (int) - Required - The zero-based index of the element to get.

### Returns
- **object** - The element at the specified index.
```

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

### Int32AnimationUsingKeyFrames Properties

Source: https://www.noesisengine.com/docs/Gui.Animation._Int32AnimationUsingKeyFrames.html

KeyFrames: Gets the collection of KeyFrame objects that define the animation. IsAdditive: Identifies the IsAdditive dependency property. IsCumulative: Identifies the IsCumulative dependency property. TargetPropertyType: Returns the type of property that can be animated by this animation. AccelerationRatio: Gets or sets a value specifying the percentage of the timeline's Duration spent accelerating the passage of time from zero to its maximum rate. AutoReverse: Gets or sets a value that indicates whether the timeline plays in reverse after it completes a forward iteration. BeginTime: Gets or sets the time at which this Timeline should begin. DecelerationRatio: Gets or sets a value specifying the percentage of the timeline's Duration spent decelerating the passage of time from its maximum rate to zero. Duration: Gets or sets the length of time for which this timeline plays, not counting repetitions. FillBehavior: Gets or sets a value that specifies how the animation behaves after it reaches the end of its active period. Name: Gets or sets the name of this Timeline. RepeatBehavior: Gets or sets the repeating behavior of this timeline. SpeedRatio: Gets or sets the rate, relative to its parent, at which time progresses for this Timeline. CanFreeze: Gets a value that indicates whether the object can be made unmodifiable. IsFrozen: Gets a value that indicates whether the object is currently modifiable. ThreadId: Gets the thread this DispatcherObject is associated with. DesiredFrameRate: Gets or sets the desired frame rate for this timeline and its child timelines.

```APIDOC
## Properties

### From Int32AnimationUsingKeyFrames
- **KeyFrames** (Int32KeyFrameCollection) - Gets the collection of KeyFrame objects that define the animation.

### From AnimationTimeline
- **IsAdditive** (bool) - Identifies the IsAdditive dependency property.
- **IsCumulative** (bool) - Identifies the IsCumulative dependency property.
- **TargetPropertyType** (Type) - Returns the type of property that can be animated by this animation.

### From Timeline
- **AccelerationRatio** (double) - Gets or sets a value specifying the percentage of the timeline's Duration spent accelerating the passage of time from zero to its maximum rate.
- **AutoReverse** (bool) - Gets or sets a value that indicates whether the timeline plays in reverse after it completes a forward iteration.
- **BeginTime** (Nullable<TimeSpan>) - Gets or sets the time at which this Timeline should begin.
- **DecelerationRatio** (double) - Gets or sets a value specifying the percentage of the timeline's Duration spent decelerating the passage of time from its maximum rate to zero.
- **Duration** (Duration) - Gets or sets the length of time for which this timeline plays, not counting repetitions.
- **FillBehavior** (FillBehavior) - Gets or sets a value that specifies how the animation behaves after it reaches the end of its active period.
- **Name** (string) - Gets or sets the name of this Timeline.
- **RepeatBehavior** (RepeatBehavior) - Gets or sets the repeating behavior of this timeline.
- **SpeedRatio** (double) - Gets or sets the rate, relative to its parent, at which time progresses for this Timeline.

### From Freezable
- **CanFreeze** (bool) - Gets a value that indicates whether the object can be made unmodifiable.
- **IsFrozen** (bool) - Gets a value that indicates whether the object is currently modifiable.

### From DispatcherObject
- **ThreadId** (int) - Gets the thread this DispatcherObject is associated with. Returns NoThreadId when this object is not attached to any thread.

## Attached Properties

### From Timeline
- **DesiredFrameRate** (Nullable<int>) - Gets or sets the desired frame rate for this timeline and its child timelines.
```

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

### Basic Binding Example

Source: https://www.noesisengine.com/docs/Gui.Core._Binding.html

Demonstrates a simple binding to a data source property using XAML.

```xaml
<TextBlock Text="{Binding Source={StaticResource myDataSource}, Path=PersonName}"/>
```

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

### XAML UserControl Example

Source: https://www.noesisengine.com/docs/Gui.Core.CppArchitectureGuide.html

Example of a UserControl in XAML that utilizes a registered converter.

```xaml
<UserControl
    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
    xmlns:local="clr-namespace:Scoreboard"
    x:Class="Scoreboard.MainWindow"
    FontFamily="Fonts/#Cheboygan">

  <UserControl.Resources>
    <ResourceDictionary>
        <local:ThousandConverter x:Key="ThousandConverter"/>
    </ResourceDictionary>
  </UserControl.Resources>
</UserControl>

```

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

### Custom Application Launcher Implementation

Source: https://www.noesisengine.com/docs/Gui.Core.ApplicationTutorial.html

Implement a custom AppLauncher to register components, provide embedded XAML and font resources, and customize resource loading.

```cpp
class AppLauncher final: public ApplicationLauncher
{
private:
    void RegisterComponents() const override
    {
        RegisterComponent<RssReader::App>();
        RegisterComponent<RssReader::MainWindow>();
    }

    Ptr<XamlProvider> GetXamlProvider() const override
    {
        EmbeddedXaml xamls[] =
        {
            { "App.xaml", App_xaml },
            { "MainWindow.xaml", MainWindow_xaml }
        };

        return *new EmbeddedXamlProvider(xamls);
    }

    Ptr<FontProvider> GetFontProvider() const override
    {
        EmbeddedFont fonts[] =
        {
            { "", Roboto_Regular_ttf },
            { "", Roboto_Bold_ttf }
        };

        return *new EmbeddedFontProvider(fonts);
    }
};

```

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

### MoveFocusAction Example Usage

Source: https://www.noesisengine.com/docs/App.Interactivity._MoveFocusAction.html

Example of how to use MoveFocusAction within a XAML Interaction.Triggers.

```APIDOC
## Example Usage

```xaml
<Grid
  xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
  xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
  xmlns:b="http://schemas.microsoft.com/xaml/behaviors"
  xmlns:noesis="clr-namespace:NoesisGUIExtensions;assembly=Noesis.GUI.Extensions">
  <b:Interaction.Triggers>
    <b:KeyTrigger Key="D">
      <noesis:MoveFocusAction Direction="Right"/>
    </b:KeyTrigger>
  </b:Interaction.Triggers>
</Grid>
```
```

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

### MainWindow C++ Implementation

Source: https://www.noesisengine.com/docs/Gui.Core.ApplicationTutorial.html

Implements the code-behind logic for the MainWindow, handling UI element initialization, event connections, and navigation between RSS feed items. Requires the NoesisGUI framework.

```cpp
namespace RssReader
{
    class MainWindow final: public Window
    {
    public:
        MainWindow(): _index(0)
        {
            InitializeComponent();

            _title = FindName<TextBlock>("EntryTitle");
            _title->SetText(gTitles[0]);

            _desc = FindName<TextBlock>("EntryDesc");
            _desc->SetText(gBodies[0]);
        }

    private:
        void InitializeComponent()
        {
            Noesis::GUI::LoadComponent(this, "MainWindow.xaml");
        }

        bool ConnectEvent(BaseComponent* source, const char* event, const char* handler) override
        {
            NS_CONNECT_EVENT(Button, Click, OnGoToClicked);
            NS_CONNECT_EVENT(Button, Click, OnPrevClicked);
            NS_CONNECT_EVENT(Button, Click, OnNextClicked);
            return false;
        }

        void OnGoToClicked(BaseComponent* /*sender*/, const RoutedEventArgs& /*e*/)
        {
        }

        void OnPrevClicked(BaseComponent* /*sender*/, const RoutedEventArgs& /*e*/)
        {
            _index = _index == 0 ? 2 : _index - 1;
            _title->SetText(gTitles[_index]);
            _desc->SetText(gBodies[_index]);
        }

        void OnNextClicked(BaseComponent* /*sender*/, const RoutedEventArgs& /*e*/)
        {
            _index = _index == 2 ? 0 : _index + 1;
            _title->SetText(gTitles[_index]);
            _desc->SetText(gBodies[_index]);
        }

    private:
        int _index;
        TextBlock* _title;
        TextBlock* _desc;

        NS_IMPLEMENT_INLINE_REFLECTION(MainWindow, Window)
        {

```

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

### ItemsControl XAML Example

Source: https://www.noesisengine.com/docs/Gui.Core._ItemsControl.html

An example demonstrating how to use the ItemsControl with a custom ItemTemplate in XAML.

```APIDOC
## ItemsControl XAML Example

```xaml
<ItemsControl>
  <ItemsControl.ItemTemplate>
    <DataTemplate>
      <Grid Margin="0,0,0,5">
        <Grid.ColumnDefinitions>
          <ColumnDefinition Width="*"/>
          <ColumnDefinition Width="100"/>
        </Grid.ColumnDefinitions>
        <TextBlock Text="{Binding Title}"/>
        <ProgressBar Grid.Column="1" Minimum="0" Maximum="100" Value="{Binding Completion}"/>
      </Grid>
    </DataTemplate>
  </ItemsControl.ItemTemplate>
</ItemsControl>
```
```

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

### Start DoubleAnimation

Source: https://www.noesisengine.com/docs/Gui.Animation.SingleTimelines.html

Creates and starts a DoubleAnimation, composing it with existing animations on the target property.

```cpp
Ptr<DoubleAnimation> animation = NsCreateComponent<DoubleAnimation>();
animation->SetFrom(40.0f);
animation->SetTo(60.0f);
animation->Start(targetObject, targetProperty, HandoffBehavior_Compose);
```

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

### Load Application Resources with Theme

Source: https://www.noesisengine.com/docs/Gui.Core.SDKGuide.html

Load application-wide resources, such as styles and templates, using a specified theme. This example loads the DarkBlue theme.

```cpp
Noesis::GUI::LoadApplicationResources(NoesisApp::Theme::DarkBlue());

```

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

### XAML DoubleAnimation Example

Source: https://www.noesisengine.com/docs/Gui.Animation.SingleTimelines.html

Example of a DoubleAnimation defined in XAML, specifying 'From', 'By', and 'Duration'.

```xaml
<DoubleAnimation From="150" By="300" Duration="0:0:2"/>
```

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

### Start DoubleAnimation with AnimationClock

Source: https://www.noesisengine.com/docs/Gui.Animation.SingleTimelines.html

Creates a DoubleAnimation, generates an AnimationClock from it, and then starts the clock on multiple targets.

```cpp
Ptr<DoubleAnimation> animation = NsCreateComponent<DoubleAnimation>();
animation->SetFrom(40.0f);
animation->SetTo(60.0f);

Ptr<AnimationClock> clock = animation->CreateClock();
clock->Start(targetObject1, targetProperty1, HandoffBehavior_Compose);
clock->Start(targetObject2, targetProperty2, HandoffBehavior_Compose);
```

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

### Initialize NoesisGUI with Custom Handlers

Source: https://www.noesisengine.com/docs/Gui.Core.SDKGuide.html

Initialize NoesisGUI and optionally set custom log, error, and memory handlers before calling Init(). Install your license before initialization.

```cpp
void main()
{
    Noesis::SetLogHandler([](const char*, uint32_t, uint32_t level, const char*, const char* msg)
    {
        // [TRACE] [DEBUG] [INFO] [WARNING] [ERROR]
        const char* prefixes[] = { "T", "D", "I", "W", "E" };
        printf("[NOESIS/%s] %s\n", prefixes[level], msg);
    });

    // Sets the active license
    Noesis::GUI::SetLicense(NS_LICENSE_NAME, NS_LICENSE_KEY);

    // Noesis initialization. This must be the first step before using any NoesisGUI functionality
    Noesis::GUI::Init();

    // ...
}

```

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

### Create and Configure a Path in C++

Source: https://www.noesisengine.com/docs/Gui.Core._Path.html

Demonstrates creating a StreamGeometry with arcs and then using it to define a Path element. The Path is then filled with red and added to a Canvas.

```cpp
// Geometry
Ptr<StreamGeometry> geometry = MakePtr<StreamGeometry()>;

StreamGeometryContext context = geometry->Open();
context.BeginFigure(Point(260.0f, 200.0f), true);
context.ArcTo(Point(140.0f, 200.0f), Size(60.0f, 60.0f), 0, false, true);
context.ArcTo(Point(260.0f, 200.0f), Size(60.0f, 60.0f), 0, false, true);
context.Close();

// Path
Ptr<Path> path = MakePtr<Path>();
Ptr<Brush> red = MakePtr<SolidColorBrush>(Color::Red);
path->SetFill(red);
path->SetData(geometry);

// Root canvas
Ptr<Canvas> root = MakePtr<Canvas()>;
Ptr<Brush> gray = MakePtr<SolidColorBrush>(Color::LightGray);
root->SetBackground(gray);
root->GetChildren()->Add(path);

```

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

### XAML ColorAnimation Example

Source: https://www.noesisengine.com/docs/Gui.Animation.SingleTimelines.html

Example of a ColorAnimation defined in XAML, specifying 'From', 'To', 'Duration', and 'Autoreverse'.

```xaml
<ColorAnimation From="Red" To="Green" Duration="0:0:2" Autoreverse="True"/>
```

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

### AlternationConverter Usage Example

Source: https://www.noesisengine.com/docs/Gui.Core._AlternationConverter.html

This example demonstrates how to use AlternationConverter in XAML to apply different background colors to ListBox items.

```APIDOC
## AlternationConverter Usage Example

### Description
This example shows how to use the `AlternationConverter` to cycle through a list of `SolidColorBrush` values for the background of `ListBoxItem` elements. The `AlternationCount` property on the `ListBox` determines how many values from the converter are used before cycling begins.

### XAML
```xml
<Grid
  xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
  xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml">

    <Grid.Resources>
        <AlternationConverter x:Key="backgroundConverter">
            <SolidColorBrush>Silver</SolidColorBrush>
            <SolidColorBrush>Gray</SolidColorBrush>
        </AlternationConverter>
        <Style x:Key="listItemStyle" TargetType="{x:Type ListBoxItem}">
            <Setter Property="Background"
                Value="{Binding Path=(ItemsControl.AlternationIndex), 
                    RelativeSource={RelativeSource Self},
                    Converter={StaticResource backgroundConverter}}"/>
        </Style>
    </Grid.Resources>

    <ListBox AlternationCount="2" ItemsSource="{Binding Items}"
        ItemContainerStyle="{StaticResource listItemStyle}"/>

</Grid>
```
```

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

### Set Up Main Render Target and Viewport

Source: https://www.noesisengine.com/docs/Gui.Core.SDKGuide.html

Bind the main render target and viewport. Restore the GPU state after rendering offscreen textures, as this step modifies it. Clear the color and stencil buffers before rendering the UI.

```c++
glBindFramebuffer(GL_FRAMEBUFFER, 0);
glViewport(0, 0, glutGet(GLUT_WINDOW_WIDTH), glutGet(GLUT_WINDOW_HEIGHT));

glClearColor(0.0f, 0.0f, 0.25f, 0.0f);
glsClearStencil(0);
gglClear(GL_COLOR_BUFFER_BIT | GL_STENCIL_BUFFER_BIT);

```

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

### KeyTrigger Usage Example

Source: https://www.noesisengine.com/docs/App.Interactivity._KeyTrigger.html

This example shows how to use KeyTrigger within XAML to invoke a command when the Escape key is pressed.

```xaml
<UserControl
  xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
  xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
  xmlns:b="http://schemas.microsoft.com/xaml/behaviors">
  <b:Interaction.Triggers>
    <b:KeyTrigger FiredOn="KeyDown" Key="Escape">
      <b:InvokeCommandAction Command="{Binding ExitCommand}" />
    </b:KeyTrigger>
  </b:Interaction.Triggers>
  ...
</UserControl>
```
Tokens:
Raw