Skip to content

Commit 5f2b227

Browse files
learn-build-service-prod[bot]learn-build-service-prod[bot]
authored
Merge pull request #11069 from MicrosoftDocs/main638945246663355501sync_temp
For protected branch, push strategy should use PR and merge to target branch method to work around git push error
2 parents 8a93eba + b11374b commit 5f2b227

File tree

4 files changed

+61
-40
lines changed

4 files changed

+61
-40
lines changed

‎.openpublishing.redirection.json‎

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -5,6 +5,11 @@
55
"redirect_url": "/visualstudio/msbuild/msbuild",
66
"redirect_document_id": false
77
},
8+
{
9+
"source_path": "docs/ide/reference/xaml-designer.md",
10+
"redirect_url": "/visualstudio/xaml-tools/xaml-designer",
11+
"redirect_document_id": false
12+
},
813
{
914
"source_path": "docs/ide/reference/options-text-editor-xml-formatting.md",
1015
"redirect_url": "/visualstudio/xml-tools/options-text-editor-xml-formatting",

‎docs/toc.yml‎

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -990,8 +990,6 @@
990990
href: ide/reference/options-text-editor-fsharp-intellisense.md
991991
- name: Windows Forms Designer
992992
href: ide/reference/options-windows-forms-designer.md
993-
- name: XAML Designer
994-
href: ide/reference/xaml-designer.md
995993
- name: Problem Details window
996994
href: ide/reference/problem-details-window.md
997995
- name: Toolbox window

‎docs/xaml-tools/toc.yml‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -20,6 +20,8 @@
2020
href: walkthrough-binding-to-data-in-xaml-designer.md
2121
- name: Debug or disable project code
2222
href: debugging-or-disabling-project-code-in-xaml-designer.md
23+
- name: Configure XAML Designer settings
24+
href: xaml-designer.md
2325
- name: XAML Design Time Data
2426
href: xaml-designtime-data.md
2527
- name: XAML Design Time Sample Data

‎docs/ide/reference/xaml-designer.md‎ renamed to ‎docs/xaml-tools/xaml-designer.md‎

Lines changed: 54 additions & 38 deletions
Original file line numberDiff line numberDiff line change
@@ -1,71 +1,83 @@
11
---
2-
title: XAML Designer options page
3-
description: Learn how to use the General page in the XAML Designer section to specify how elements and attributes are formatted in your XAML documents.
4-
ms.date: 03/02/2017
5-
ms.topic: reference
6-
f1_keywords:
7-
- VS.ToolsOptionsPages.XAMLDesigner
8-
- VS.ToolsOptionsPages.XAML_Designer.General
9-
ms.custom: "ide-ref"
2+
title: Configure XAML Designer in Visual Studio
3+
description: Learn to enable and customize XAML Designer options in Visual Studio to optimize your XAML editing experience.
4+
ms.date: 03/02/2025
5+
ms.topic: how-to
106
author: maddymontaquila
117
ms.author: maleger
128
manager: mijacobs
139
ms.subservice: general-ide
10+
#customer intent: As a Visual Studio user, I want to enable and configure XAML Designer options so that I can work more efficiently with XAML documents.
1411
---
15-
# XAML Designer options page
1612

17-
Use the **XAML Designer** options page to specify how elements and attributes are formatted in your XAML documents. To open this page, choose the **Tools** menu and then choose **Options**. To access the **XAML Designer** property page, choose the **XAML Designer** node. Settings for the XAML Designer are applied when you open the document. So, if you make changes to the settings, you need to close and then reopen Visual Studio to see the changes.
13+
# Configure XAML Designer options in Visual Studio
1814

19-
> [!NOTE]
20-
> The dialog boxes and menu commands you see might differ from those described in Help depending on your active settings or edition. To change your settings, choose **Import and Export Settings** on the **Tools** menu. For more information, see [Reset settings](../personalizing-the-visual-studio-ide.md#reset-all-settings).
15+
The XAML Designer in Visual Studio lets you visually edit XAML documents for WPF and UWP projects. By enabling and customizing Designer options, you can streamline your workflow and tailor the editing experience to your needs. This article guides you through enabling the Designer and configuring its key options.
2116

22-
## Enable XAML Designer
17+
## Prerequisites
2318

24-
When selected, this setting enables the XAML Designer. The XAML Designer provides a visual work area for you to edit XAML documents. Certain functionality in Visual Studio, such as IntelliSense for resources and databinding, require the XAML Designer to be enabled.
19+
- Visual Studio installed
20+
- A XAML-based project (such as WPF or UWP)
2521

26-
The following settings apply only when XAML Designer is enabled. If you change this option, you will need to restart Visual Studio for the setting to take effect.
22+
## Enable the XAML Designer
2723

28-
## Default document view
24+
Enable the XAML Designer to access visual editing features and advanced IntelliSense for XAML documents.
2925

30-
Use this setting to control whether Design view appears when XAML documents are loaded.
26+
1. Open Visual Studio.
27+
2. Go to **Tools > Options**.
28+
3. Expand **XAML Designer** under the relevant project type (WPF/UWP).
29+
4. Check **Enable XAML Designer**.
30+
5. Click **OK** and restart Visual Studio for changes to take effect.
3131

32-
|Name|Description|
33-
|-|-|
34-
|**Source View**|Specifies whether only XAML source appears in the XAML view. This is useful when loading large documents.|
35-
|**Design View**|Specifies whether only a visual XAML Designer appears in the XAML view.|
36-
|**Split View**|Specifies whether both the visual XAML Designer and the XAML source appear next to one another in the XAML view (location based on the **Split Orientation** setting).|
32+
## Set the default document view
3733

38-
## Split Orientation
34+
Choose how XAML documents appear when opened: Source View, Design View, or Split View.
3935

40-
Use this setting to control when and how the XAML Designer appears when editing a XAML document. These settings apply only when **Default document view** is set to **Split View**.
36+
1. In Visual Studio, go to **Tools > Options > XAML Designer**.
37+
2. Find the **Default document view** setting.
38+
3. Select one:
39+
- **Source View**: Shows only XAML source code.
40+
- **Design View**: Shows only the visual Designer.
41+
- **Split View**: Shows both Designer and source side by side.
42+
4. Click **OK** to apply.
4143

42-
|Name|Description|
43-
|-|-|
44-
|**Vertical**|XAML source appears on the left side of the XAML view, and the XAML Designer appears on the other side.|
45-
|**Horizontal**|The XAML Designer appears on the top of the XAML view, and the XAML source appears below it.|
46-
|**Default**|The XAML document uses the split orientation recommended for the platform targeted by the document's project. For most platforms this is equivalent to **Horizontal**.|
44+
## Change split orientation
4745

48-
## Zoom by using
46+
Adjust the layout of Split View to suit your workflow.
4947

50-
Use this setting to determine how zoom works when editing a XAML document.
48+
1. In **Tools > Options > XAML Designer**, locate **Split Orientation**.
49+
2. Choose one:
50+
- **Vertical**: Source on the left, Designer on the right.
51+
- **Horizontal**: Designer on top, source below.
52+
- **Default**: Uses platform-recommended orientation.
53+
3. Click **OK** to save changes.
5154

52-
|Name|Description|
53-
|-|-|
54-
|**Mouse wheel**|Zoom in the XAML Designer by scrolling the mouse wheel.|
55-
|**Ctrl + mouse wheel**|Zoom in the XAML Designer by pressing the **Ctrl** key while scrolling the mouse wheel.|
56-
|**Alt + mouse wheel**|Zoom in the XAML Designer by pressing the **Alt** key while scrolling the mouse wheel.|
55+
## Configure zoom behavior
5756

58-
These settings determine Designer behavior when editing a XAML document.
57+
Set how you zoom in the XAML Designer for easier navigation.
5958

60-
## Default Zoom Setting
59+
1. In **Tools > Options > XAML Designer**, find **Zoom by using**.
60+
2. Select your preferred method:
61+
- **Mouse wheel**
62+
- **Ctrl + mouse wheel**
63+
- **Alt + mouse wheel**
64+
3. Click **OK** to confirm.
65+
66+
---
67+
For more information on resetting Visual Studio settings, see [Reset settings](../ide/personalizing-the-visual-studio-ide.md#reset-all-settings).
68+
## Default Zoom setting
6169

6270
Use this setting to determine the default zoom value for viewing the XAML document.
6371

72+
Select **Tools > Options > XAML Designer** to access the **Default Zoom Setting** property.
73+
6474
|Name|Description|
6575
|-|-|
6676
|**Last Used**|Use the last used zoom value for all the XAML documents by default. When a XAML document is opened for the first time, then it will use "Fit All" setting for the first time only.|
6777
|**Fit All**|Use this option to set the zoom value to "Fit All" for the XAML designer. When a XAML document is closed and reopened, then the last set value will persist for that session but for different sessions "Fit All" will be used by default.|
6878

79+
## Editor settings
80+
6981
These settings determine Designer behavior when you edit a XAML document.
7082

7183
|Name|Description|
@@ -79,6 +91,8 @@ These settings determine Designer behavior when you edit a XAML document.
7991

8092
Use these options to determine settings when editing XAML files using Blend.
8193

94+
Select **Tools > Options > XAML Designer** in Blend for Visual Studio to access Blend-specific properties.
95+
8296
|Name|Description|
8397
|-|-|
8498
|**Zoom by using**|Zoom in the XAML Designer by scrolling the mouse wheel, or by pressing the **Ctrl** or **Alt** key while scrolling the mouse wheel.|
@@ -88,6 +102,8 @@ Use these options to determine settings when editing XAML files using Blend.
88102

89103
Use these settings to determine XAML Designer behavior when editing XAML documents in Blend.
90104

105+
Select **Tools > Options > XAML Designer** in Blend to access Artboard properties.
106+
91107
### Snapping
92108

93109
|Name|Description|

0 commit comments

Comments
 (0)