Windows App SDK

https://learn.microsoft.com/en-us/windows/windows-app-sdk/api/winrt
Admin
Windows App SDK is a set of Windows Runtime (WinRT) APIs that provide developers with access to...
Tokens:5,645,625
Snippets:60,161
Trust Score:10
Update:2 weeks ago
Show doc for...
Tokens:
Raw
### C# Start property usage

Source: https://learn.microsoft.com/en-us/windows/windows-app-sdk/api/winrt/microsoft.ui.composition.compositionlinegeometry.start

C# example of getting and setting the Start property on a CompositionLineGeometry object.

```csharp
var vector2 = compositionLineGeometry.start;
compositionLineGeometry.start = vector2;
```

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

### C# usage example

Source: https://learn.microsoft.com/en-us/windows/windows-app-sdk/api/winrt/microsoft.ui.xaml.controls.mapcontrol.center

C# example showing how to get and set the Center property.

```csharp
var geopoint = mapControl.center;
mapControl.center = geopoint;
```

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

### C# get and set example

Source: https://learn.microsoft.com/en-us/windows/windows-app-sdk/api/winrt/microsoft.ui.composition.compositiongradientbrush.interpolationspace

C# example showing how to get and set the InterpolationSpace property on a CompositionGradientBrush.

```csharp
var compositionColorSpace = compositionGradientBrush.interpolationSpace;
compositionGradientBrush.interpolationSpace = compositionColorSpace;
```

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

### Install package from https source using AddPackageByUriAsync

Source: https://learn.microsoft.com/en-us/windows/windows-app-sdk/api/winrt/microsoft.windows.management.deployment.packagedeploymentmanager.addpackagebyuriasync

Example of installing a package from an https source using AddPackageByUriAsync. The code creates a Uri, gets the default PackageDeploymentManager, creates AddPackageOptions, and awaits the deployment. It checks the deployment result status and prints success or error details.

```csharp
void Install()
{
    var package = new Uri("https://contoso.com/example.msix");
    var packageDeploymentManager = PackageDeploymentManager.GetDefault();
    var options = new AddPackageOptions();
    var deploymentResult = await packageDeploymentManager.AddPackageByUriAsync(package, options);
    if (deplymentResult.Status == PackageDeploymentStatus.CompletedSuccess)
    {
        Console.WriteLine("OK");
    }
    else
    {
        Console.WriteLine("Error:{} ExtendedError:{} {}",
            deploymentResult.Error.HResult, deploymentResult.ExtendedError.HResult, deploymentResult.ErrorText);
    }
}
```

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

### C# usage example for Border.Background

Source: https://learn.microsoft.com/en-us/windows/windows-app-sdk/api/winrt/microsoft.ui.xaml.controls.border.background

C# example showing how to get and set the Background property.

```csharp
var brush = border.background;
border.background = brush;
```

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

### Start()

Source: https://learn.microsoft.com/en-us/windows/windows-app-sdk/api/winrt/microsoft.windows.search.appcontentindex.appindextextquerysession.start

Starts the text query session with default options.

```APIDOC
## Start()

### Description
Starts the text query session with default options.

### Method
Start

### Signature
```
public void Start();
```

### Parameters
None.

### Applies to
Windows App SDK 2.0 and Windows App SDK 2.0 Experimental

```

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

### JavaScript get and set example

Source: https://learn.microsoft.com/en-us/windows/windows-app-sdk/api/winrt/microsoft.windows.management.deployment.addpackageoptions.forceupdatefromanyversion

JavaScript usage example showing how to get and set the forceUpdateFromAnyVersion property on an addPackageOptions object.

```javascript
var boolean = addPackageOptions.forceUpdateFromAnyVersion;
addPackageOptions.forceUpdateFromAnyVersion = boolean;
```

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

### C# usage example

Source: https://learn.microsoft.com/en-us/windows/windows-app-sdk/api/winrt/microsoft.ui.xaml.controls.inktoolbarcustomtoolbutton.configurationcontent

Example of getting and setting the ConfigurationContent property in C#.

```csharp
var uIElement = inkToolbarCustomToolButton.configurationContent;
inkToolbarCustomToolButton.configurationContent = uIElement;
```

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

### InstallAllResources

Source: https://learn.microsoft.com/en-us/windows/windows-app-sdk/api/winrt/microsoft.windows.management.deployment.addpackageoptions

Property to install all resources.

```APIDOC
## Property: InstallAllResources

### Description
Gets or sets a value that indicates whether the app skips resource applicability checks. This effectively stages or registers all resource packages that a user passes in to the command, which forces applicability for all packages contained in a bundle. If a user passes in a bundle, all contained resource packages will be registered.

### Type
Boolean
```

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

### JavaScript get and set

Source: https://learn.microsoft.com/en-us/windows/windows-app-sdk/api/winrt/microsoft.ui.xaml.controls.colorpicker.iscolorspectrumvisible

JavaScript usage example for getting and setting the property.

```javascript
var boolean = colorPicker.isColorSpectrumVisible;
colorPicker.isColorSpectrumVisible = boolean;
```

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

### C# usage example

Source: https://learn.microsoft.com/en-us/windows/windows-app-sdk/api/winrt/microsoft.ui.xaml.media.animation.edgeuithemetransition.edge

C# usage example showing how to get and set the Edge property.

```C#
var edgeTransitionLocation = edgeUIThemeTransition.edge;
edgeUIThemeTransition.edge = edgeTransitionLocation;
```

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

### Install packages with EnsurePackageSetReadyAsync

Source: https://learn.microsoft.com/en-us/windows/windows-app-sdk/api/winrt/microsoft.windows.management.deployment.packagedeploymentmanager.ensurepackagereadyasync

C# example showing how to install a PackageSet (containing two PackageSetItem objects) if necessary, using EnsurePackageSetReadyAsync. It checks the returned PackageDeploymentResult.Status and prints either "OK" or an error message with HResult and ErrorText. Note the source contains a typo: 'deplymentResult' instead of 'deploymentResult'.

```csharp
void Install()
{
    var packageSet = new PackageSet() {
        Items = { new PackageSetItem() { PackageFamilyName = "contoso.example1_1234567890abc",
                                         MinVersion = ToVersion(1, 2, 3, 4),
                                         PackageUri = new Uri("c:\\contoso\\example1-1.2.3.4.msix") },
                { new PackageSetItem() { PackageFamilyName = "contoso.example2_1234567890abc",
                                         MinVersion = ToVersion(2, 4, 6, 8),
                                         PackageUri = new Uri("https://contoso.com/example2-2.4.6.8.msix") } };

    var packageDeploymentManager = PackageDeploymentManager.GetDefault();
    var options = new EnsureReadyOptions();
    var deploymentResult = await packageDeploymentManager.EnsurePackageSetReadyAsync(packageSet, options);
    if (deplymentResult.Status == PackageDeploymentStatus.CompletedSuccess)
    {
        Console.WriteLine("OK");
    }
    else
    {
        Console.WriteLine("Error:{} ExtendedError:{} {}",
            deploymentResult.Error.HResult, deploymentResult.ExtendedError.HResult, deploymentResult.ErrorText);
    }
}

PackageVersion ToVersion(uint major, uint minor, uint build, uint revision) =>
    new PackageVersion {
        Major = checked((ushort)major),
        Minor = checked((ushort)minor),
        Build = checked((ushort)build),
        Revision = checked((ushort)revision)
    };
```

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

### Application.Start(ApplicationInitializationCallback)

Source: https://learn.microsoft.com/en-us/windows/windows-app-sdk/api/winrt/microsoft.ui.xaml.application.start

Provides the entry point and requests initialization of the application. Use the specified ApplicationInitializationCallback to instantiate the Application class.

```APIDOC
## Application.Start(ApplicationInitializationCallback)

### Description
Provides the entry point and requests initialization of the application. Use the specified ApplicationInitializationCallback to instantiate the Application class.

### Method
Start

### Signature
public static void Start(ApplicationInitializationCallback callback);

### Parameters
- **callback** (ApplicationInitializationCallback) - Required - The callback that should be invoked during the initialization sequence.

### Remarks
This runs a message pump internally, and does not return until the application shuts down. Typically, you do not need to call this method directly. For example, in Visual Studio, the build system generates code that makes the call. The callback runs in the same thread as the main view.

### Applies to
| Product | Versions |
| --- | --- |
| Windows App SDK | 0.8, 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 1.7, 1.8, 2.0 Experimental, 2.0 |
```

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

### C# syntax and usage for InitialValue

Source: https://learn.microsoft.com/en-us/windows/windows-app-sdk/api/winrt/microsoft.ui.composition.scalarnaturalmotionanimation.initialvalue

C# syntax and usage example for the InitialValue property. The property is of type Nullable<float> and gets or sets the starting value of the animation.

```csharp
public System.Nullable<float> InitialValue { get; set; }
```

```csharp
var iReference = scalarNaturalMotionAnimation.initialValue;
scalarNaturalMotionAnimation.initialValue = iReference;
```

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

### StartProcess(String, String, UInt32)

Source: https://learn.microsoft.com/en-us/windows/windows-app-sdk/api/winrt/microsoft.ui.content.processstarter

Documentation for the ProcessStarter.StartProcess method, which starts a process with specified parameters.

```APIDOC
## StartProcess(String, String, UInt32)

### Description
Starts a process with the specified parameters.

### Method
StartProcess

### Signature
StartProcess(String, String, UInt32)

### Parameters
- **String** - The first string parameter.
- **String** - The second string parameter.
- **UInt32** - The unsigned 32-bit integer parameter.

### Return Value
No return value is documented.

### Applies to
- **Product**: Windows App SDK
- **Versions**: 2.0 Experimental
```

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

### JavaScript usage example for AppNotification.Tag

Source: https://learn.microsoft.com/en-us/windows/windows-app-sdk/api/winrt/microsoft.windows.appnotifications.appnotification.tag

JavaScript example showing how to get and set the Tag property.

```javascript
var string = appNotification.tag;
appNotification.tag = string;
```

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

### DoubleAnimation.From Property

Source: https://learn.microsoft.com/en-us/windows/windows-app-sdk/api/winrt/microsoft.ui.xaml.media.animation.doubleanimation.from

Documentation for the DoubleAnimation.From property, which gets or sets the starting value of a DoubleAnimation. Includes property value type, default, syntax examples in multiple languages, and applicable product versions.

```APIDOC
## DoubleAnimation.From Property

### Description
Gets or sets the animation's starting value.

### Property Value
- **Type**: IReference<double> (projected as double? in C#)
- **Default**: null

### Syntax

#### C#
```csharp
public System.Nullable<double> From { get; set; }
```

#### C++/CX
```cpp
public:
    property IReference<double>^ From {
        IReference<double>^ get();
        void set(IReference<double>^ value);
    }
```

#### C++/WinRT
```cpp
IReference<double> From();
void From(IReference<double> value);
```

#### Visual Basic
```vb
Public Property From As Nullable(Of Double)
```

#### JavaScript
```javascript
var iReference = doubleAnimation.from;
doubleAnimation.from = iReference;
```

#### XAML
```xaml
<DoubleAnimation From="double"/>
```

### Applies To
- Windows App SDK: 0.8, 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 1.7, 1.8, 2.0 Experimental, 2.0
```

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

### JavaScript usage of installAllResources

Source: https://learn.microsoft.com/en-us/windows/windows-app-sdk/api/winrt/microsoft.windows.management.deployment.stagepackageoptions.installallresources

JavaScript usage example for the installAllResources property. Shows how to read and set the property on a stagePackageOptions object.

```javascript
var boolean = stagePackageOptions.installAllResources;
stagePackageOptions.installAllResources = boolean;
```

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

### C# ChromeMedium get and set example

Source: https://learn.microsoft.com/en-us/windows/windows-app-sdk/api/winrt/microsoft.ui.xaml.colorpaletteresources.chromemedium

C# example of getting and setting the ChromeMedium property.

```csharp
var iReference = colorPaletteResources.chromeMedium;
colorPaletteResources.chromeMedium = iReference;
```

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

### Start(TextQueryOptions, String)

Source: https://learn.microsoft.com/en-us/windows/windows-app-sdk/api/winrt/microsoft.windows.search.appcontentindex.appindextextquerysession.start

Starts the text query session with the specified query options and an initial query phrase.

```APIDOC
## Start(TextQueryOptions, String)

### Description
Starts the text query session with the specified query options and an initial query phrase.

### Method
Start

### Signature
```
public void Start(TextQueryOptions options, string firstQueryPhrase);
```

### Parameters
- **options** (TextQueryOptions) - Required - The query options to use.
- **firstQueryPhrase** (String) - Required - The initial query phrase.

### Applies to
Windows App SDK 2.0 and Windows App SDK 2.0 Experimental

```

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

### Install an .msix package with AddPackageAsync

Source: https://learn.microsoft.com/en-us/windows/windows-app-sdk/api/winrt/microsoft.windows.management.deployment.packagedeploymentmanager.addpackageasync

Example of installing a package from an .msix file using PackageDeploymentManager.AddPackageAsync. It checks the deployment result status and prints an error message with HResult values and error text if the deployment fails.

```C#
void Install()
{
    var package = "d:\\contoso\\example.msix";
    var packageDeploymentManager = PackageDeploymentManager.GetDefault();
    var options = new AddPackageOptions();
    var deploymentResult = await packageDeploymentManager.AddPackageAsync(package, options);
    if (deplymentResult.Status == PackageDeploymentStatus.CompletedSuccess)
    {
        Console.WriteLine("OK");
    }
    else
    {
        Console.WriteLine("Error:{} ExtendedError:{} {}",
            deploymentResult.Error.HResult, deploymentResult.ExtendedError.HResult, deploymentResult.ErrorText);
    }
}
```

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

### JavaScript ListTab get and set example

Source: https://learn.microsoft.com/en-us/windows/windows-app-sdk/api/winrt/microsoft.ui.text.itextparagraphformat.listtab

JavaScript example showing how to get and set the ListTab property.

```javascript
var single = iTextParagraphFormat.listTab;
iTextParagraphFormat.listTab = single;
```

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

### Example: enumerate execution providers (C# and C++/WinRT)

Source: https://learn.microsoft.com/en-us/windows/windows-app-sdk/api/winrt/microsoft.windows.ai.machinelearning.executionprovidercatalog.findallproviders

Example usage of FindAllProviders in C# and C++/WinRT. Both examples retrieve the default ExecutionProviderCatalog, call FindAllProviders, and iterate over the returned providers to print each provider's name and device type.

```csharp
var catalog = Microsoft.Windows.AI.MachineLearning.ExecutionProviderCatalog.GetDefault();
var providers = catalog.FindAllProviders();
foreach (var provider in providers)
{
    Console.WriteLine($"Found provider: {provider.Name}, Type: {provider.DeviceType}");
}

```

```cpp
auto catalog = winrt::Microsoft::Windows::AI::MachineLearning::ExecutionProviderCatalog::GetDefault();
auto providers = catalog.FindAllProviders();
for (const auto& provider : providers)
{
    std::wcout << L"Found provider: " << provider.Name().c_str() 
              << L", Type: " << static_cast<int>(provider.DeviceType()) << L"\n";
}

```

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

### C# usage example

Source: https://learn.microsoft.com/en-us/windows/windows-app-sdk/api/winrt/microsoft.ui.content.systemvisualsitebridge.site

Shows how to access the Site property from a SystemVisualSiteBridge instance.

```csharp
var contentSite = systemVisualSiteBridge.site;
```

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

### JavaScript CoordinateSpace get and set example

Source: https://learn.microsoft.com/en-us/windows/windows-app-sdk/api/winrt/microsoft.ui.composition.pointlight.coordinatespace

JavaScript usage example for getting and setting the CoordinateSpace property.

```javascript
var visual = pointLight.coordinateSpace;
pointLight.coordinateSpace = visual;
```

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

### C# examples of Navigate with different transition animations

Source: https://learn.microsoft.com/en-us/windows/windows-app-sdk/api/winrt/microsoft.ui.xaml.controls.frame.navigate

C# examples showing how to call Navigate with different NavigationTransitionInfo objects: default animation, EntranceNavigationTransitionInfo, DrillInNavigationTransitionInfo, and SuppressNavigationTransitionInfo.

```csharp
// Play the default animation
myFrame.Navigate(typeof(Page2), null);

// Explicitly play the page refresh animation
myFrame.Navigate(typeof(Page2), null, new EntranceNavigationTransitionInfo());

// Play the drill in animation
myFrame.Navigate(typeof(Page2), null, new DrillInNavigationTransitionInfo());

// Suppress the default animation
myFrame.Navigate(typeof(Page2), null, new SuppressNavigationTransitionInfo());
```

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

### C# OverrideScale get and set example

Source: https://learn.microsoft.com/en-us/windows/windows-app-sdk/api/winrt/microsoft.ui.content.desktopattachedsitebridge.overridescale

C# example of getting and setting the OverrideScale property on a DesktopAttachedSiteBridge instance.

```csharp
var single = desktopAttachedSiteBridge.overrideScale;
desktopAttachedSiteBridge.overrideScale = single;
```

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

### C++/WinRT example: SetupBackdrop with MicaController

Source: https://learn.microsoft.com/en-us/windows/windows-app-sdk/api/winrt/microsoft.ui.composition.systembackdrops.isystembackdropcontroller.settarget

Shows how to draw the Mica material in a Win32 app window using C++/WinRT. Creates a MicaController and calls SetTarget with the window ID and composition target.

```cppwinrt
bool SetupBackdrop(winrt::Microsoft::UI::WindowId windowId, winrt::Windows::UI::Composition::CompositionTarget compositionTarget)
{
    winrt::Microsoft::UI::Composition::SystemBackdrops::MicaController micaController = winrt::MicaController();
    return micaController.SetTarget(windowId, compositionTarget);
}
```

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

### C# CenterPoint get and set example

Source: https://learn.microsoft.com/en-us/windows/windows-app-sdk/api/winrt/microsoft.ui.composition.compositionsurfacebrush.centerpoint

C# example of getting and setting the CenterPoint property on a CompositionSurfaceBrush object.

```csharp
var vector2 = compositionSurfaceBrush.centerPoint;
compositionSurfaceBrush.centerPoint = vector2;
```

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

### Enumerate and Register Execution Providers (C# and C++/WinRT)

Source: https://learn.microsoft.com/en-us/windows/windows-app-sdk/api/winrt/microsoft.windows.ai.machinelearning.executionprovider.tryregister

Example showing how to enumerate all execution providers, ensure each is ready, and attempt registration with TryRegister. Outputs success or failure for each provider.

```C#
var catalog = Microsoft.Windows.AI.MachineLearning.ExecutionProviderCatalog.GetDefault();
var providers = catalog.FindAllProviders();
foreach (var provider in providers)
{
    await provider.EnsureReadyAsync();
    bool registered = provider.TryRegister();
    Console.WriteLine($"Provider {provider.Name} registration: {(registered ? "Success" : "Failed")}");
}

```

```C++/WinRT
auto catalog = winrt::Microsoft::Windows::AI::MachineLearning::ExecutionProviderCatalog::GetDefault();
auto providers = catalog.FindAllProviders();
for (const auto& provider : providers)
{
    provider.EnsureReadyAsync().get();
    bool registered = provider.TryRegister();
    std::wcout << L"Provider " << provider.Name().c_str() 
              << L" registration: " << (registered ? L"Success" : L"Failed") << L"\n";
}

```

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

### JavaScript ProtectedText get and set example

Source: https://learn.microsoft.com/en-us/windows/windows-app-sdk/api/winrt/microsoft.ui.text.itextcharacterformat.protectedtext

JavaScript example showing how to get and set the ProtectedText property on an ITextCharacterFormat object.

```javascript
var formatEffect = iTextCharacterFormat.protectedText;
iTextCharacterFormat.protectedText = formatEffect;
```

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

### Install packages via PackageSet

Source: https://learn.microsoft.com/en-us/windows/windows-app-sdk/api/winrt/microsoft.windows.management.deployment.packagedeploymentmanager.addpackagesetasync

Example of a Fabrikam app installing Contoso's Example1 and Example2 packages via a PackageSet. Creates a PackageSet with two PackageSetItems, calls AddPackageByUriAsync, and prints OK on success or error details on failure.

```C#
void Install()
{
    var packageSet = new PackageSet() {
        Items = { new PackageSetItem() { PackageUri = new Uri("c:\\contoso\\example1-1.2.3.4.msix") },
                { new PackageSetItem() { PackageUri = new Uri("https://contoso.com/example2-2.4.6.8.msix") } };

    var packageDeploymentManager = PackageDeploymentManager.GetDefault();
    var options = new AddPackageOptions();
    var deploymentResult = await packageDeploymentManager.AddPackageByUriAsync(packageSet, options);
    if (deplymentResult.Status == PackageDeploymentStatus.CompletedSuccess)
    {
        Console.WriteLine("OK");
    }
    else
    {
        Console.WriteLine("Error:{} ExtendedError:{} {}",
            deploymentResult.Error.HResult, deploymentResult.ExtendedError.HResult, deploymentResult.ErrorText);
    }
}
```

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

### JavaScript DelayTime get and set example

Source: https://learn.microsoft.com/en-us/windows/windows-app-sdk/api/winrt/microsoft.ui.composition.keyframeanimation.delaytime

JavaScript example showing how to get and set the delayTime property on a keyFrameAnimation object.

```javascript
var timeSpan = keyFrameAnimation.delayTime;
keyFrameAnimation.delayTime = timeSpan;
```

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

### JavaScript AnchorPoint get and set example

Source: https://learn.microsoft.com/en-us/windows/windows-app-sdk/api/winrt/microsoft.ui.composition.compositiongradientbrush.anchorpoint

JavaScript example showing how to get and set the AnchorPoint property on a CompositionGradientBrush object.

```javascript
var vector2 = compositionGradientBrush.anchorPoint;
compositionGradientBrush.anchorPoint = vector2;
```

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

### Show()

Source: https://learn.microsoft.com/en-us/windows/windows-app-sdk/api/winrt/microsoft.ui.windowing.appwindow.show

Shows the window and activates it.

```APIDOC
### Method
Show()

### Description
Shows the window and activates it.

### Parameters
None.

### Returns
Void.

### Example
```csharp
appWindow.Show();
```
```

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

### C# usage example

Source: https://learn.microsoft.com/en-us/windows/windows-app-sdk/api/winrt/microsoft.windows.appnotifications.builder.appnotificationbutton.tooltip

Shows how to set the ToolTip property and build a notification.

```csharp
var button = new AppNotificationButton("Reply")
    .AddArgument("action", "reply");

if (AppNotificationButton.IsToolTipSupported())
{
    button.ToolTip = "Click to reply.";
}

var notification = new AppNotificationBuilder()
    .AddText("Notification text.")
    .AddButton(button)
    .BuildNotification();

AppNotificationManager.Default.Show(notification);
```

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

### Example: enumerate execution providers (Python)

Source: https://learn.microsoft.com/en-us/windows/windows-app-sdk/api/winrt/microsoft.windows.ai.machinelearning.executionprovidercatalog.findallproviders

Example usage of FindAllProviders in Python. It retrieves the default ExecutionProviderCatalog, calls find_all_providers, and prints each provider's name and device type.

```python
catalog = winml.ExecutionProviderCatalog.get_default()
providers = catalog.find_all_providers()
for provider in providers:
    print(f"Found provider: {provider.name}, Type: {provider.device_type}")

```

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

### JavaScript get and set intermediateValue

Source: https://learn.microsoft.com/en-us/windows/windows-app-sdk/api/winrt/microsoft.ui.xaml.controls.slider.intermediatevalue

JavaScript example showing how to get and set the intermediateValue property on a Slider object. Note that the variable name 'double' is used in the example.

```javascript
var double = slider.intermediateValue;
slider.intermediateValue = double;
```

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

### Start()

Source: https://learn.microsoft.com/en-us/windows/windows-app-sdk/api/winrt/microsoft.ui.xaml.dispatchertimer

Starts the DispatcherTimer.

```APIDOC
## Start()

### Description
Starts the DispatcherTimer.

### Syntax
```csharp
public void Start();
```

### Remarks
Call this method to begin the timer. The Tick event will fire after the time specified in the Interval property has elapsed, and will continue to fire at the same interval until Stop is called.
```

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

### TextPointer ElementStart { get; }

Source: https://learn.microsoft.com/en-us/windows/windows-app-sdk/api/winrt/microsoft.ui.xaml.documents.textelement.elementstart

Gets a TextPointer that represents the position just before the start of the TextElement.

```APIDOC
## TextElement.ElementStart Property

### Description
Gets a TextPointer that represents the position just before the start of the element.

### Property
`public TextPointer ElementStart { get; }`

### Property Value
- **TextPointer** - A TextPointer that represents the position just before the start of the TextElement.

### Applies to
- Windows App SDK: 0.8, 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 1.7, 1.8, 2.0 Experimental, 2.0
```

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

### Install packages with EnsurePackageSetReadyAsync

Source: https://learn.microsoft.com/en-us/windows/windows-app-sdk/api/winrt/microsoft.windows.management.deployment.packagedeploymentmanager.ensurepackagesetreadyasync

Example of a Fabrikam app installing Contoso's Example1 and Example2 packages if necessary, with explicit user confirmation before installation. Uses PackageDeploymentManager.GetDefault(), IsPackageSetReady, and EnsurePackageSetReadyAsync. Note the typo 'deplymentResult' in the source.

```C#
void Install()
{
    var packageSet = new PackageSet() {
        Items = { new PackageSetItem() { PackageFamilyName = "contoso.example1_1234567890abc",
                                         MinVersion = ToVersion(1, 2, 3, 4),
                                         PackageUri = new Uri("c:\\contoso\\example1-1.2.3.4.msix") },
                { new PackageSetItem() { PackageFamilyName = "contoso.example2_1234567890abc",
                                         MinVersion = ToVersion(2, 4, 6, 8),
                                         PackageUri = new Uri("https://contoso.com/example2-2.4.6.8.msix") } };

    var packageDeploymentManager = PackageDeploymentManager.GetDefault();
    if (!packageDeploymentManager.IsPackageSetReady(packageSet))
    {
        bool ok = PromptUserForConfirmation();
        if (!ok)
        {
            return;
        }
    }

    var options = new EnsureReadyOptions();
    var deploymentResult = await packageDeploymentManager.EnsurePackageSetReadyAsync(packageSet, options);
    if (deplymentResult.Status == PackageDeploymentStatus.CompletedSuccess)
    {
        Console.WriteLine("OK");
    }
    else
    {
        Console.WriteLine("Error:{} ExtendedError:{} {}",
            deploymentResult.Error.HResult, deploymentResult.ExtendedError.HResult, deploymentResult.ErrorText);
    }
}

PackageVersion ToVersion(uint major, uint minor, uint build, uint revision) =>
    new PackageVersion {
        Major = checked((ushort)major),
        Minor = checked((ushort)minor),
        Build = checked((ushort)build),
        Revision = checked((ushort)revision)
    };
```

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

### Check package readiness before deployment with IsPackageReady

Source: https://learn.microsoft.com/en-us/windows/windows-app-sdk/api/winrt/microsoft.windows.management.deployment.packagedeploymentmanager.ispackageready

Example showing how to use IsPackageReady before calling EnsurePackageReadyAsync to prompt the user for consent before installing the target package. The example uses PackageDeploymentManager().GetDefault(), checks IsPackageReady, and then calls EnsurePackageReadyAsync with EnsureReadyOptions.

```csharp
var pdm = PackageDeploymentManager().GetDefault();
if (!pdm.IsPackageReady(pkg))
{
    bool ok = AskUserForConsent(pkg);
    if (ok)
    {
        var options = new EnsureReadyOptions();
        var result = await pdm.EnsurePackageReadyAsync(pkg, options);
    }
}
```

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

### JavaScript usage example

Source: https://learn.microsoft.com/en-us/windows/windows-app-sdk/api/winrt/microsoft.ui.xaml.automation.provider.iwindowprovider.visualstate

JavaScript example showing how to retrieve the visual state of the window.

```javascript
var windowVisualState = iWindowProvider.visualState;
```

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

### C# usage example for InfoBar.ContentTemplate

Source: https://learn.microsoft.com/en-us/windows/windows-app-sdk/api/winrt/microsoft.ui.xaml.controls.infobar.contenttemplate

C# example showing how to get and set the ContentTemplate property on an InfoBar instance.

```C#
var dataTemplate = infoBar.contentTemplate;
infoBar.contentTemplate = dataTemplate;
```

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

### C# usage example

Source: https://learn.microsoft.com/en-us/windows/windows-app-sdk/api/winrt/microsoft.ui.xaml.automation.windowpatternidentifiers.windowvisualstateproperty

C# example showing how to retrieve the WindowVisualStateProperty automation property.

```csharp
var automationProperty = WindowPatternIdentifiers.windowVisualStateProperty;
```

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

### C# usage example

Source: https://learn.microsoft.com/en-us/windows/windows-app-sdk/api/winrt/microsoft.ui.xaml.controls.anchorrequestedeventargs.anchor

Example of getting and setting the Anchor property in C#.

```csharp
var uIElement = anchorRequestedEventArgs.anchor;
anchorRequestedEventArgs.anchor = uIElement;
```

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

### Start(TextQueryOptions)

Source: https://learn.microsoft.com/en-us/windows/windows-app-sdk/api/winrt/microsoft.windows.search.appcontentindex.appindextextquerysession.start

Starts the text query session with the specified query options.

```APIDOC
## Start(TextQueryOptions)

### Description
Starts the text query session with the specified query options.

### Method
Start

### Signature
```
public void Start(TextQueryOptions options);
```

### Parameters
- **options** (TextQueryOptions) - Required - The query options to use.

### Applies to
Windows App SDK 2.0 and Windows App SDK 2.0 Experimental

```

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

### JavaScript TintOpacity get and set

Source: https://learn.microsoft.com/en-us/windows/windows-app-sdk/api/winrt/microsoft.ui.xaml.media.acrylicbrush.tintopacity

JavaScript usage example for getting and setting TintOpacity.

```javascript
var double = acrylicBrush.tintOpacity;
acrylicBrush.tintOpacity = double;
```

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

### Create and configure a SpotLight in C#

Source: https://learn.microsoft.com/en-us/windows/windows-app-sdk/api/winrt/microsoft.ui.composition.spotlight

Creates a SpotLight, sets its coordinate space, cone angles, colors, offset, and adds a target visual. CoordinateSpace is required; if not set, the SpotLight will not render.

```C#
_spotLight = _compositor.CreateSpotLight(); 
_spotLight.CoordinateSpace = root; 
_spotLight.InnerConeAngleInDegrees = 30; 
_spotLight.InnerConeColor = Colors.Red; 
_spotLight.OuterConeAngleInDegrees = 45; 
_spotLight.OuterConeColor = Colors.Yellow; 
_spotLight.Offset = new Vector3(30, 30, 200); 
_spotLight.Targets.Add(root); 

```

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

### FileOpenPicker.SuggestedStartLocation property declaration and usage

Source: https://learn.microsoft.com/en-us/windows/windows-app-sdk/api/winrt/microsoft.windows.storage.pickers.fileopenpicker.suggestedstartlocation

Shows the property declaration and usage for FileOpenPicker.SuggestedStartLocation in multiple languages. The C# usage example demonstrates getting and setting the property on a fileOpenPicker instance.

```C++/CX
public:
 property PickerLocationId SuggestedStartLocation { PickerLocationId get(); void set(PickerLocationId value); };
```

```C++/WinRT
PickerLocationId SuggestedStartLocation();

void SuggestedStartLocation(PickerLocationId value);
```

```C#
public PickerLocationId SuggestedStartLocation { get; set; }
```

```C#
var pickerLocationId = fileOpenPicker.suggestedStartLocation;
fileOpenPicker.suggestedStartLocation = pickerLocationId;
```

```VB
Public Property SuggestedStartLocation As PickerLocationId
```

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

### C# usage example

Source: https://learn.microsoft.com/en-us/windows/windows-app-sdk/api/winrt/microsoft.windows.media.capture.cameracaptureuivideocapturesettings.maxresolution

Shows how to get and set the MaxResolution property in C#.

```csharp
var cameraCaptureUIMaxVideoResolution = cameraCaptureUIVideoCaptureSettings.maxResolution;
cameraCaptureUIVideoCaptureSettings.maxResolution = cameraCaptureUIMaxVideoResolution;
```

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

### FileSavePicker.SuggestedStartFolder Property

Source: https://learn.microsoft.com/en-us/windows/windows-app-sdk/api/winrt/microsoft.windows.storage.pickers.filesavepicker.suggestedstartfolder

Gets or sets the suggested start folder that the file save picker dialog displays when it opens.

```APIDOC
## FileSavePicker.SuggestedStartFolder Property

### Description
Gets or sets the suggested start folder that the file save picker dialog displays when it opens.

### Property Value
- **Type**: String (Platform::String, winrt::hstring)
- **Description**: A string representing the path of the suggested start folder.

### Remarks
Once the user picks from a directory, the file save picker silently ignores `SuggestedStartFolder`. If you define both `SuggestedStartFolder` and SuggestedStartLocation, `SuggestedStartFolder` takes precedence. If the folder isn't found, the file save picker falls back to SuggestedStartLocation.

### Applies to
- **Windows App SDK**: 2.0 Experimental, 2.0

### See Also
- SuggestedStartLocation

### Code Examples

#### C++/CX
```cpp
public:
    property Platform::String ^ SuggestedStartFolder {
        Platform::String ^ get();
        void set(Platform::String ^ value);
    }
```

#### C++/WinRT
```cpp
winrt::hstring SuggestedStartFolder();
void SuggestedStartFolder(winrt::hstring value);
```

#### C#
```csharp
public string SuggestedStartFolder { get; set; }
```

#### JavaScript
```javascript
var string = fileSavePicker.suggestedStartFolder;
fileSavePicker.suggestedStartFolder = string;
```

#### VB
```vb
Public Property SuggestedStartFolder As String
```
```

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

### C++/WinRT example: Using PickFolderResult with FolderPicker

Source: https://learn.microsoft.com/en-us/windows/windows-app-sdk/api/winrt/microsoft.windows.storage.pickers.pickfolderresult

Shows how to use the PickFolderResult class to get the folder path of a selected folder in C++/WinRT. The example creates a FolderPicker, calls PickSingleFolderAsync, and then converts the result to a StorageFolder using GetFolderFromPathAsync. Includes error handling for null results.

```cpp
#include <winrt/Microsoft.Windows.Storage.Pickers.h>
using namespace winrt::Microsoft::Windows::Storage::Pickers;

FolderPicker picker;
auto& result{ co_await openPicker.PickSingleFolderAsync() };
if (result)
{
    // Perform this conversion if you have business logic that uses StorageFolder
    auto& storageFolder{ co_await winrt::Windows::Storage::StorageFolder::GetFolderFromPathAsync(result.Path) }
    // Continue your business logic with storageFolder
}
else
{
    // Add error handling logic here
}

```

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

### JavaScript MinColumnSpacing get and set

Source: https://learn.microsoft.com/en-us/windows/windows-app-sdk/api/winrt/microsoft.ui.xaml.controls.uniformgridlayout.mincolumnspacing

JavaScript usage example for getting and setting MinColumnSpacing.

```javascript
var double = uniformGridLayout.minColumnSpacing;
uniformGridLayout.minColumnSpacing = double;
```

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

### C# usage example for CompositionNineGridBrush.RightInset

Source: https://learn.microsoft.com/en-us/windows/windows-app-sdk/api/winrt/microsoft.ui.composition.compositionninegridbrush.rightinset

C# example showing how to get and set the RightInset property on a CompositionNineGridBrush instance.

```csharp
var single = compositionNineGridBrush.rightInset;
compositionNineGridBrush.rightInset = single;
```

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

### Add Example1 and Example2 packages to the package graph (C#)

Source: https://learn.microsoft.com/en-us/windows/windows-app-sdk/api/winrt/microsoft.windows.management.deployment.packageruntimemanager.addpackageset

Example of a Fabrikam app using Contoso's Example1 and Example2 packages via Dynamic Dependencies, installing them if necessary. The packages are added to the package graph and not explicitly removed (they stay until process termination).

```csharp
void AddExample1AndExample2ToThePackageGraph()
{
    var packageSet = new PackageSet() {
        Items = { new PackageSetItem() { PackageFamilyName = "contoso.example1_1234567890abc",
                                         MinVersion = ToVersion(1, 2, 3, 4),
                                         PackageUri = new Uri("c:\\contoso\\example1-1.2.3.4.msix") },
                { new PackageSetItem() { PackageFamilyName = "contoso.example2_1234567890abc",
                                         MinVersion = ToVersion(2, 4, 6, 8),
                                         PackageUri = new Uri("https://contoso.com/example2-2.4.6.8.msix") } };

    var packageDeploymentManager = PackageDeploymentManager.GetDefault();
    var options = new EnsureReadyOptions();
    var deploymentResult = await packageDeploymentManager.EnsurePackageSetReadyAsync(packageSet, options);
    if (deplymentResult.Status == PackageDeploymentStatus.CompletedSuccess)
    {
        Console.WriteLine("OK");
    }
    else
    {
        Console.WriteLine("Error:{} ExtendedError:{} {}",
            deploymentResult.Error.HResult, deploymentResult.ExtendedError.HResult, deploymentResult.ErrorText);
    }

    var packageRuntimeManager = PackageRuntimeManager.GetDefault();
    var packageSetRuntimeDisposition = packageRuntimeManager.AddPackageSet(packageSet);
}

PackageVersion ToVersion(uint major, uint minor, uint build, uint revision) =>
    new PackageVersion {
        Major = checked((ushort)major),
        Minor = checked((ushort)minor),
        Build = checked((ushort)build),
        Revision = checked((ushort)revision)
    };
```

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

### JavaScript get and set FileOpenPicker.settingsIdentifier

Source: https://learn.microsoft.com/en-us/windows/windows-app-sdk/api/winrt/microsoft.windows.storage.pickers.fileopenpicker.settingsidentifier

JavaScript example showing how to get and set the settingsIdentifier property on a FileOpenPicker instance.

```javascript
var string = fileOpenPicker.settingsIdentifier;
fileOpenPicker.settingsIdentifier = string;
```

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

### Creating and Running an Animation in Code

Source: https://learn.microsoft.com/en-us/windows/windows-app-sdk/api/winrt/microsoft.ui.xaml.media.animation.storyboard

This example shows how to programmatically create a Storyboard, configure animations, and execute them.

```XAML
<Button Content="Create animation" Click="Button_Click"/>
```

```C#
private void Button_Click(object sender, RoutedEventArgs e)
{
    Create_And_Run_Animation();
}

private void Create_And_Run_Animation()
{
    Storyboard justintimeStoryboard = null;
    // If the storyboard already exists in the resources dictionary,
    // get it and make sure it's stopped.
    if (LayoutRoot.Resources.ContainsKey("justintimeStoryboard"))
    {
        justintimeStoryboard = (Storyboard)LayoutRoot.Resources["justintimeStoryboard"];
        justintimeStoryboard.Stop();
    }
    // Otherwise, create the storyboard and add it to the resources dictionary.
    else
    {
        // Create a red rectangle that will be the target
        // of the animation.
        Rectangle myRectangle = new Rectangle();
        myRectangle.Width = 200;
        myRectangle.Height = 200;
        SolidColorBrush myBrush = new SolidColorBrush(Colors.Red);
        myRectangle.Fill = myBrush;

        // Create the transform.
        TranslateTransform moveTransform = new TranslateTransform();
        moveTransform.X = 0;
        moveTransform.Y = 0;
        myRectangle.RenderTransform = moveTransform;

        // Add the rectangle to the tree.
        LayoutRoot.Children.Add(myRectangle);

        // Create a duration of 2 seconds.
        Duration duration = new Duration(TimeSpan.FromSeconds(2));
        // Create two DoubleAnimations and set their properties.
        DoubleAnimation myDoubleAnimationX = new DoubleAnimation();
        DoubleAnimation myDoubleAnimationY = new DoubleAnimation();
        myDoubleAnimationX.Duration = duration;
        myDoubleAnimationY.Duration = duration;
        justintimeStoryboard = new Storyboard();
        justintimeStoryboard.Duration = duration;
        justintimeStoryboard.Children.Add(myDoubleAnimationX);
        justintimeStoryboard.Children.Add(myDoubleAnimationY);
        Storyboard.SetTarget(myDoubleAnimationX, moveTransform);
        Storyboard.SetTarget(myDoubleAnimationY, moveTransform);

        // Set the X and Y properties of the Transform to be the target properties
        // of the two respective DoubleAnimations.
        Storyboard.SetTargetProperty(myDoubleAnimationX, "X");
        Storyboard.SetTargetProperty(myDoubleAnimationY, "Y");
        myDoubleAnimationX.To = 200;
        myDoubleAnimationY.To = 200;

        // Make the Storyboard a resource.
        LayoutRoot.Resources.Add("justintimeStoryboard", justintimeStoryboard);
    }

    // Begin the animation.
    justintimeStoryboard.Begin();
}
```

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

### C# get and set OffContentTemplate

Source: https://learn.microsoft.com/en-us/windows/windows-app-sdk/api/winrt/microsoft.ui.xaml.controls.toggleswitch.offcontenttemplate

C# example of getting and setting the OffContentTemplate property.

```C#
var dataTemplate = toggleSwitch.offContentTemplate;
toggleSwitch.offContentTemplate = dataTemplate;
```

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

### JavaScript tailVisibility get and set

Source: https://learn.microsoft.com/en-us/windows/windows-app-sdk/api/winrt/microsoft.ui.xaml.controls.teachingtip.tailvisibility

JavaScript example showing get and set of tailVisibility.

```javascript
var teachingTipTailVisibility = teachingTip.tailVisibility;
teachingTip.tailVisibility = teachingTipTailVisibility;
```

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

### Python Example: ExecutionProviderCatalog.GetDefault

Source: https://learn.microsoft.com/en-us/windows/windows-app-sdk/api/winrt/microsoft.windows.ai.machinelearning.executionprovidercatalog.getdefault

Python example that retrieves the default ExecutionProviderCatalog instance.

```python
catalog = winml.ExecutionProviderCatalog.get_default()
```

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

### UpdateWidget usage example in C++

Source: https://learn.microsoft.com/en-us/windows/windows-app-sdk/api/winrt/microsoft.windows.widgets.providers.widgetmanager.updatewidget

C++ example showing typical usage of UpdateWidget. It calls GetWidgetInfos to get active widgets, then for each active widget creates a WidgetUpdateRequestOptions with a visual template and data, and passes it to UpdateWidget.

```C++
using namespace winrt;
using namespace Microsoft::Windows::Widgets;
using namespace Microsoft::Windows::Widgets::Providers;

class WidgetManagerOperations
{
    void InitializeWidgets(hstring myWidgetId)
    {
        WidgetManager widgetManager = WidgetManager::GetDefault();
        com_array<WidgetInfo> widgetInfos = widgetManager.GetWidgetInfos();

        for (const auto& widgetInfo : widgetInfos)
        {
            if (widgetInfo.WidgetContext().IsActive())
            {
                WidgetUpdateRequestOptions options{myWidgetId};
                options.Template(LR"({
                    "type": "AdaptiveCard",
                    "version": "1.5",
                    "body": [
                        {
                            "type": "TextBlock",
                            "text": "${greeting}"
                        }
                    ]
                })");

                options.Data(LR"({
                    "greeting": "Hello"
                })");

                widgetManager.UpdateWidget(options);
            }
        }
    }
}
```

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

### Check and Provision Package Set with IsPackageSetProvisioned

Source: https://learn.microsoft.com/en-us/windows/windows-app-sdk/api/winrt/microsoft.windows.management.deployment.packagedeploymentmanager.ispackagesetprovisioned

C# example showing how to check whether a package set is provisioned using IsPackageSetProvisioned, and if not, prompt the user for confirmation, then stage and provision the packages. Requires administrative privileges. Note the example contains apparent typos (deplymentResult, options used before declaration) as in the original source.

```csharp
void Install()
{
    // We want to check what's provisioned by PackageFamilyName. If something's
    // not provisioned, then we'll also need MinVersion and PackageUri to Stage and
    // Provision. But checking whether a family is provisioned supports only some
    // URI schemes (notably, not the one that we need for our staging work). So we'll
    // define the PackageSet with the families that we want checked, and if something's
    // not provisioned, then we'll add the additional properties needed.

    var packageSet = new PackageSet() {
        Items = { new PackageSetItem() { PackageFamilyName = "contoso.example1_1234567890abc" },
                { new PackageSetItem() { PackageFamilyName = "contoso.example2_1234567890abc" }
        }
    };

    var packageDeploymentManager = PackageDeploymentManager.GetDefault();
    if (packageDeploymentManager.IsPackageSetProvisioned(packageSet))
    {
        return;
    }

    bool ok = PromptUserForConfirmation();
    if (!ok)
    {
        return;
    }

    packageSet.Items()[0].MinVersion(ToVersion(1, 2, 3, 4));
    packageSet.Items()[0].PackageUri(new Uri("c:\\contoso\\example1-1.2.3.4.msix"));
    packageSet.Items()[1].MinVersion(ToVersion(2, 4, 6, 8));
    packageSet.Items()[1].PackageUri(new Uri("https://contoso.com/example2-2.4.6.8.msix"));

    var stageOptions = new StagePackageOptions();
    var deploymentResult = await packageDeploymentManager.StagePackageSetReadyAsync(packageSet, options);
    if (deplymentResult.Status == PackageDeploymentStatus.CompletedSuccess)
    {
        Console.WriteLine("Staged");
    }
    else
    {
        Console.WriteLine("Error:{} ExtendedError:{} {}",
            deploymentResult.Error.HResult, deploymentResult.ExtendedError.HResult, deploymentResult.ErrorText);
        return;
    }

    var options = new ProvisionPackageOptions();
    var deploymentResult = await packageDeploymentManager.ProvisionPackageSetReadyAsync(packageSet, options);
    if (deplymentResult.Status == PackageDeploymentStatus.CompletedSuccess)
    {
        Console.WriteLine("Provisioned");
    }
    else
    {
        Console.WriteLine("Error:{} ExtendedError:{} {}",
            deploymentResult.Error.HResult, deploymentResult.ExtendedError.HResult, deploymentResult.ErrorText);
    }
}

PackageVersion ToVersion(uint major, uint minor, uint build, uint revision) =>
    new PackageVersion {
        Major = checked((ushort)major),
        Minor = checked((ushort)minor),
        Build = checked((ushort)build),
        Revision = checked((ushort)revision)
    };
```

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

### JavaScript get and set ignoredInputKinds

Source: https://learn.microsoft.com/en-us/windows/windows-app-sdk/api/winrt/microsoft.ui.xaml.controls.scrollview.ignoredinputkinds

JavaScript example of getting and setting the ignoredInputKinds property.

```javascript
var scrollingInputKinds = scrollView.ignoredInputKinds;
scrollView.ignoredInputKinds = scrollingInputKinds;
```

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

### C# example: Using PickFolderResult with FolderPicker

Source: https://learn.microsoft.com/en-us/windows/windows-app-sdk/api/winrt/microsoft.windows.storage.pickers.pickfolderresult

Shows how to use the PickFolderResult class to get the folder path of a selected folder in C#. The example creates a FolderPicker, calls PickFolderAsync, and then converts the result to a StorageFolder using GetFolderFromPathAsync. Includes error handling for null results.

```csharp
using Microsoft.Windows.Storage.Pickers;

var picker = new FolderPicker();
var result = await picker.PickFolderAsync();
if (result != null)
{
    // Perform this conversion if you have business logic that uses StorageFolder
    var storageFolder = await Windows.Storage.StorageFolder.GetFolderFromPathAsync(result.Path)
    // Continue your business logic with storageFolder
}
else
{
    // Add error handling logic here
}

```

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

### JavaScript get and set textMatchType

Source: https://learn.microsoft.com/en-us/windows/windows-app-sdk/api/winrt/microsoft.windows.search.appcontentindex.textqueryoptions.textmatchtype

JavaScript usage example showing how to get and set the textMatchType property.

```javascript
var textLexicalMatchType = textQueryOptions.textMatchType;
textQueryOptions.textMatchType = textLexicalMatchType;
```

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

### JavaScript horizontalScrollRailMode get and set

Source: https://learn.microsoft.com/en-us/windows/windows-app-sdk/api/winrt/microsoft.ui.xaml.controls.primitives.scrollpresenter.horizontalscrollrailmode

JavaScript example of getting and setting the horizontalScrollRailMode property.

```javascript
var scrollingRailMode = scrollPresenter.horizontalScrollRailMode;
scrollPresenter.horizontalScrollRailMode = scrollingRailMode;
```

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

### C++/WinRT example: SetupBackdrop with DesktopAcrylicController.SetTarget

Source: https://learn.microsoft.com/en-us/windows/windows-app-sdk/api/winrt/microsoft.ui.composition.systembackdrops.desktopacryliccontroller.settarget

C++/WinRT example showing how to draw the Desktop Acrylic material in a Win32 app window. The SetupBackdrop function creates a DesktopAcrylicController and calls SetTarget with the window ID and composition target. This method must be called on a thread with a DispatcherQueue, and for Win32 apps the DWM window attribute DWMWA_USE_HOSTBACKDROPBRUSH must be set on the top-level hWnd.

```cppwinrt
bool SetupBackdrop(winrt::Microsoft::UI::WindowId windowId, winrt::Windows::UI::Composition::CompositionTarget compositionTarget)
{
    winrt::Microsoft::UI::Composition::SystemBackdrops::DesktopAcrylicController desktopAcrylicController = winrt::DesktopAcrylicController();
    return desktopAcrylicController.SetTarget(windowId, compositionTarget);
}
```

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

### JavaScript ContentOrientation get and set

Source: https://learn.microsoft.com/en-us/windows/windows-app-sdk/api/winrt/microsoft.ui.xaml.controls.primitives.scrollpresenter.contentorientation

JavaScript example of getting and setting the ContentOrientation property.

```javascript
var scrollingContentOrientation = scrollPresenter.contentOrientation;
scrollPresenter.contentOrientation = scrollingContentOrientation;
```

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

### C# Example: ExecutionProviderCatalog.GetDefault

Source: https://learn.microsoft.com/en-us/windows/windows-app-sdk/api/winrt/microsoft.windows.ai.machinelearning.executionprovidercatalog.getdefault

C# example that retrieves the default ExecutionProviderCatalog instance.

```csharp
var catalog = Microsoft.Windows.AI.MachineLearning.ExecutionProviderCatalog.GetDefault();
```

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

### Storyboard.Begin Method

Source: https://learn.microsoft.com/en-us/windows/windows-app-sdk/api/winrt/microsoft.ui.xaml.media.animation.storyboard.begin

Documentation for the Storyboard.Begin method, which initiates the set of animations associated with the storyboard.

```APIDOC
## Storyboard.Begin Method

### Description
Initiates the set of animations associated with the storyboard. Calling this method begins all the animations that are in the Children collection of the Storyboard. Begin starts the animations from their initial state, a clock time of zero. If you want to restart an animation where Pause had been called previously and continue from the clock time where it was paused, use Resume instead.

### Method
Begin

### Syntax
```csharp
public void Begin();
```

### Remarks
Calling this method begins all the animations that are in the Children collection of the Storyboard. Begin starts the animations within the Storyboard from their initial state, a clock time of zero. If you want to restart an animation where Pause had been called previously, and continue on from the clock time where it was paused, use Resume instead.

### Applies to
- Windows App SDK: 0.8, 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 1.7, 1.8, 2.0 Experimental, 2.0

### See also
- Stop()
- GetCurrentTime()
- Children
- Storyboarded animations
```

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

### Get and set rotationAngleInDegrees

Source: https://learn.microsoft.com/en-us/windows/windows-app-sdk/api/winrt/microsoft.ui.composition.compositionclip.rotationangleindegrees

Example of getting and setting the rotationAngleInDegrees property on a CompositionClip object.

```csharp
var single = compositionClip.rotationAngleInDegrees;
compositionClip.rotationAngleInDegrees = single;
```

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

### XAML example for setting up buttons

Source: https://learn.microsoft.com/en-us/windows/windows-app-sdk/api/winrt/microsoft.ui.xaml.automation.automationproperties.getflowsto

XAML markup that declares four buttons in a StackPanel. The example uses these buttons to demonstrate overriding the default UI Automation reading order.

```xaml
<StackPanel>
    <Button x:Name="first">First</Button>
    <Button x:Name="third">Third</Button>
    <Button x:Name="second">Second</Button>
    <Button x:Name="fourth">Fourth</Button>
</StackPanel>
```

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

### JavaScript usage example

Source: https://learn.microsoft.com/en-us/windows/windows-app-sdk/api/winrt/microsoft.ui.xaml.controls.twopaneview.tallmodeconfiguration

JavaScript example showing how to get and set the tallModeConfiguration property.

```javascript
var twoPaneViewTallModeConfiguration = twoPaneView.tallModeConfiguration;
twoPaneView.tallModeConfiguration = twoPaneViewTallModeConfiguration;
```
Tokens:
Raw