diff --git a/wpf/Ribbon/Backstage.md b/wpf/Ribbon/Backstage.md index 455128d3a..359319b4f 100644 --- a/wpf/Ribbon/Backstage.md +++ b/wpf/Ribbon/Backstage.md @@ -2,7 +2,7 @@ layout: post title: Backstage in WPF Ribbon control | Syncfusion® description: Learn about Backstage support in Syncfusion® Essential Studio® WPF Ribbon control, its elements and more. -platform: WPF +platform: wpf control: Ribbon documentation: ug --- @@ -101,7 +101,7 @@ syncfusionskin:SfSkinManager.VisualStyle="Office2013White" > {% endtabs %} -![WPF Ribbon displays BackStage](GettingStarted_images/wpf-ribbon-backstage.jpg) +![WPF Ribbon displays BackStage](getting-started_images/wpf-ribbon-back-stage.jpg) ### Customize the BackStage Visibility @@ -285,7 +285,7 @@ syncfusionskin:SfSkinManager.VisualStyle="Office2013White" > {% endtabs %} -![WPF Ribbon Backstage with BackStageCommandButton](GettingStarted_images/wpf-ribbon-backstage-commandbutton.jpg) +![WPF Ribbon Backstage with BackStageCommandButton](getting-started_images/wpf-ribbon-backstage-commandbutton.jpg) ## Setting image to BackStageCommandButton @@ -419,7 +419,7 @@ The [`IconTemplate`](https://help.syncfusion.com/cr/wpf/Syncfusion.Windows.Tools {% endtabs %} - ![WPF Ribbon Backstage displays Image for BackStageCommandButton](GettingStarted_images/wpf-ribbon-backstage-commandbutton-icon.png) + ![WPF Ribbon Backstage displays Image for BackStageCommandButton](getting-started_images/wpf-ribbon-backstage-commandbutton-icon.png) N> [View sample in GitHub](https://github.com/SyncfusionExamples/syncfusion-wpf-ribbon-examples/tree/main/Samples/Setting-icons-using-IconTemplate) @@ -493,7 +493,7 @@ The [`IconTemplate`](https://help.syncfusion.com/cr/wpf/Syncfusion.Windows.Tools {% endtabs %} - ![WPF Ribbon Backstage displays Image for BackStageCommandButton](GettingStarted_images/wpf-ribbon-backstage-icon.png) + ![WPF Ribbon Backstage displays Image for BackStageCommandButton](getting-started_images/wpf-ribbon-backstage-icon.png) ### Setting vector image @@ -598,7 +598,7 @@ The [`IconTemplate`](https://help.syncfusion.com/cr/wpf/Syncfusion.Windows.Tools {% endtabs %} - ![WPF Ribbon Backstage displays Image for BackstageButton using VectorImage](GettingStarted_images/wpf-ribbon-backstage-button-with-image.png) + ![WPF Ribbon Backstage displays Image for BackstageButton using VectorImage](getting-started_images/wpf-ribbon-backstage-button-with-image.png) ## Add BackStageTabItem @@ -704,7 +704,7 @@ syncfusionskin:SfSkinManager.VisualStyle="Office2013White" > {% endtabs %} -![WPF Ribbon Backstage with BackStageTabItem](GettingStarted_images/wpf-ribbon-backstage-tabitem.jpg) +![WPF Ribbon Backstage with BackStageTabItem](getting-started_images/wpf-ribbon-backstage-tabitem.jpg) ## Add BackStage separator @@ -811,7 +811,7 @@ syncfusionskin:SfSkinManager.VisualStyle="Office2013White" > {% endtabs %} -![WPF Ribbon Backstage with BackStageSeparator](GettingStarted_images/wpf-ribbon-backstage-with-separator.jpg) +![WPF Ribbon Backstage with BackStageSeparator](getting-started_images/wpf-ribbon-backstage-with-separator.jpg) ## BackStage items position @@ -926,7 +926,7 @@ syncfusionskin:SfSkinManager.VisualStyle="Office2019Colorful" Width="820" Height {% endtabs %} -![Changinh BackStageItems Position in WPF Ribbon Backstage](GettingStarted_images/wpf-ribbon-backstage-item-position.jpg) +![Changinh BackStageItems Position in WPF Ribbon Backstage](getting-started_images/wpf-ribbon-backstage-item-position.jpg) N> [View sample in GitHub](https://github.com/SyncfusionExamples/syncfusion-wpf-ribbon-examples/tree/main/Samples/Positioning-BackStageItems) @@ -1236,7 +1236,7 @@ When the [`PlacementType`](https://help.syncfusion.com/cr/wpf/Syncfusion.Windows {% endtabs %} -![WPF Ribbon BackStage Placed in RibbonWindow as FullScreen](GettingStarted_images/wpf-ribbon-backstage-in-ribbonwindow.png) +![WPF Ribbon BackStage Placed in RibbonWindow as FullScreen](getting-started_images/wpf-ribbon-backstage-in-ribbonwindow.png) #### Backstage placed in MS Window @@ -1450,7 +1450,7 @@ When the [`PlacementType`](https://help.syncfusion.com/cr/wpf/Syncfusion.Windows {% endtabs %} -![WPF Ribbon BackStage Placed in MS Window as FullScreen](GettingStarted_images/wpf-ribbon-backstage-in-ms-window.png) +![WPF Ribbon BackStage Placed in MS Window as FullScreen](getting-started_images/wpf-ribbon-backstage-in-ms-window.png) #### Backstage placed in Placement target @@ -1670,7 +1670,7 @@ When the [`PlacementType`](https://help.syncfusion.com/cr/wpf/Syncfusion.Windows {% endtabs %} -![WPF Ribbon BackStage Placed in Target Element as FullScreen](GettingStarted_images/wpf-ribbon-backstage-target-placement.png) +![WPF Ribbon BackStage Placed in Target Element as FullScreen](getting-started_images/wpf-ribbon-backstage-target-placement.png) ### Place the backstage in BelowTab @@ -1886,7 +1886,7 @@ When the [`PlacementType`](https://help.syncfusion.com/cr/wpf/Syncfusion.Windows {% endtabs %} -![WPF Ribbon BackStage Placed in RibbonWindow as BelowTab](GettingStarted_images/wpf-ribbon-backstage-in-belowtab.png) +![WPF Ribbon BackStage Placed in RibbonWindow as BelowTab](getting-started_images/wpf-ribbon-backstage-in-belowtab.png) #### Backstage placed in MS Window @@ -2100,7 +2100,7 @@ When the [`PlacementType`](https://help.syncfusion.com/cr/wpf/Syncfusion.Windows {% endtabs %} -![WPF Ribbon BackStage Placed in MS Window as BelowTab](GettingStarted_images/wpf-ribbon-backstage-belowtab-mswindow.png) +![WPF Ribbon BackStage Placed in MS Window as BelowTab](getting-started_images/wpf-ribbon-backstage-belowtab-mswindow.png) #### Backstage placed in Placement target @@ -2320,11 +2320,170 @@ When the [`PlacementType`](https://help.syncfusion.com/cr/wpf/Syncfusion.Windows {% endtabs %} -![WPF Ribbon BackStage Placed in Target Element as BelowTab](GettingStarted_images/wpf-ribbon-backstage-belowtab-placement.png) +![WPF Ribbon BackStage Placed in Target Element as BelowTab](getting-started_images/wpf-ribbon-backstage-belowtab-placement.png) N> View [sample](https://github.com/SyncfusionExamples/How-to-set-placement-type-and-placement-target-for-Backstage) in GitHub. -## Customize the BackStageButton visibility +## Customization of BackStageButton + +The BackStage button in Ribbon can be customized to change its header text, apply a custom header template, or control its visibility. + +### BackStageHeader + +The `BackStageHeader` property allows you to set the header text for the Backstage button in the Ribbon. By default, this header is displayed as File in plain text. + +{% tabs %} + +{% highlight XAML %} + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +{% endhighlight %} + +{% tabs %} + +![WPF Ribbon BackStage Header](getting-started_images/wpf-ribbon-backstageheader.png) + +### BackstageHeaderTemplate + +The `BackStageHeaderTemplate` property allows you to customize the Backstage header by applying a DataTemplate. This enables you to define a custom layout, such as adding an icon and text. + +The following code example illustrates how to customize the Backstage header. + +{% endtabs %} + +{% highlight XAML %} + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +{% endhighlight %} + +{% endtabs %} + +![WPF Ribbon BackStageButton header template support by using BackStageHeaderTemplate property](getting-started_images/wpf-ribbon-backstagebutton-template.png) + +### BackStageButton visibility Ribbon control allows to show or hide the `BackStageButton` by using its `Visibility` property. @@ -2404,5 +2563,4 @@ private void MainWindow_Loaded(object sender, RoutedEventArgs e) {% endtabs %} -![WPF Ribbon BackStageButton collapsed by using Visibility property](GettingStarted_images/wpf-ribbon-backstagebutton-visibility.png) - +![WPF Ribbon BackStageButton collapsed by using Visibility property](getting-started_images/wpf-ribbon-backstagebutton-visibility.png) \ No newline at end of file diff --git a/wpf/Ribbon/getting-started_images/wpf-ribbon-backstagebutton-template.png b/wpf/Ribbon/getting-started_images/wpf-ribbon-backstagebutton-template.png new file mode 100644 index 000000000..51f29ff2a Binary files /dev/null and b/wpf/Ribbon/getting-started_images/wpf-ribbon-backstagebutton-template.png differ diff --git a/wpf/Ribbon/getting-started_images/wpf-ribbon-backstageheader.png b/wpf/Ribbon/getting-started_images/wpf-ribbon-backstageheader.png new file mode 100644 index 000000000..f537c9a73 Binary files /dev/null and b/wpf/Ribbon/getting-started_images/wpf-ribbon-backstageheader.png differ