Skip to content

Commit e1911d0

Browse files
author
msebolt
committed
resource file consolidation pr8
1 parent 65be4d9 commit e1911d0

8 files changed

Lines changed: 132 additions & 218 deletions

‎.openpublishing.redirection.json‎

Lines changed: 25 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -7380,6 +7380,31 @@
73807380
"redirect_url": "/cpp/windows/selecting-controls",
73817381
"redirect_document_id": false
73827382
},
7383+
{
7384+
"source_path": "docs/windows/aligning-controls-on-a-guide.md",
7385+
"redirect_url": "/cpp/windows/dialog-editor-states-guides-and-grids",
7386+
"redirect_document_id": false
7387+
},
7388+
{
7389+
"source_path": "docs/windows/creating-and-setting-guides-and-margins.md",
7390+
"redirect_url": "/cpp/windows/dialog-editor-states-guides-and-grids",
7391+
"redirect_document_id": false
7392+
},
7393+
{
7394+
"source_path": "docs/windows/disabling-guides.md",
7395+
"redirect_url": "/cpp/windows/dialog-editor-states-guides-and-grids",
7396+
"redirect_document_id": false
7397+
},
7398+
{
7399+
"source_path": "docs/windows/guide-settings-dialog-box.md",
7400+
"redirect_url": "/cpp/windows/dialog-editor-states-guides-and-grids",
7401+
"redirect_document_id": false
7402+
},
7403+
{
7404+
"source_path": "docs/windows/modifying-the-layout-grid.md",
7405+
"redirect_url": "/cpp/windows/dialog-editor-states-guides-and-grids",
7406+
"redirect_document_id": false
7407+
},
73837408
{
73847409
"source_path": "docs/windows/activationfactory-activationfactory-constructor.md",
73857410
"redirect_url": "/cpp/windows/activationfactory-class#activationfactory",

‎docs/windows/TOC.md‎

Lines changed: 0 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -81,11 +81,6 @@
8181
###### [Setting the Width of a Horizontal Scroll Bar](setting-the-width-of-a-horizontal-scroll-bar.md)
8282
###### [Arrangement of Controls on Dialog Boxes](arrangement-of-controls-on-dialog-boxes.md)
8383
####### [Dialog Editor States (Guides and Grids)](dialog-editor-states-guides-and-grids.md)
84-
######## [Creating and Setting Guides and Margins](creating-and-setting-guides-and-margins.md)
85-
######## [Aligning Controls on a Guide](aligning-controls-on-a-guide.md)
86-
######## [Disabling Guides](disabling-guides.md)
87-
######## [Modifying the Layout Grid](modifying-the-layout-grid.md)
88-
######### [Guide Settings Dialog Box](guide-settings-dialog-box.md)
8984
####### [Grouping Radio Buttons on a Dialog Box](grouping-radio-buttons-on-a-dialog-box.md)
9085
####### [Aligning Groups of Controls](aligning-groups-of-controls.md)
9186
####### [Evening the Spacing Between Controls](evening-the-spacing-between-controls.md)

‎docs/windows/aligning-controls-on-a-guide.md‎

Lines changed: 0 additions & 38 deletions
This file was deleted.

‎docs/windows/creating-and-setting-guides-and-margins.md‎

Lines changed: 0 additions & 46 deletions
This file was deleted.
Lines changed: 107 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: "Dialog Editor States (Guides and Grids) (C++)"
33
ms.date: "11/04/2016"
4-
helpviewer_keywords: ["Dialog Editor [C++], guides and margins"]
4+
helpviewer_keywords: ["Dialog Editor [C++], guides and margins", "guides, clearing", "guides", "dialog box controls [C++], placement", "controls [C++], guides and margins", "guides, creating", "guides, moving", "margins, moving", "DLUs (dialog units)", "controls [C++], aligning", "Dialog Editor [C++], snap to guides", "guides, tick mark interval", "dialog box controls [C++], placement", "guides, aligning controls", "dialog units (DLUs)", "snap to guides (Dialog editor)", "controls [C++], sizing", "tick mark interval in Dialog editor", "controls [C++], snap to guides/grid", "guides, disabling snapping", "controls [C++], snap to guides/grid", "controls [C++], layout grid", "snap to layout grid", "grids, turning on or off", "layout grid in Dialog Editor", "grids, changing size", "grid spacing", "guides, settings", "layout grid in Dialog Editor", "controls [C++], snap to guides/grid", "Guide Settings dialog box (Dialog editor)"]
55
ms.assetid: dbacf9ef-e8b0-4125-a7ce-84911c482e98
66
---
77
# Dialog Editor States (Guides and Grids) (C++)
@@ -16,22 +16,121 @@ You can arrange controls on dialog boxes with the **Dialog** editor in one of th
1616

1717
The [Dialog Editor Toolbar](../windows/showing-or-hiding-the-dialog-editor-toolbar.md) contains buttons that control the state. To change the state, click the appropriate icon. You can also change states by using the **Guide Settings** command on the **Format** menu.
1818

19-
- [Creating and Setting Guides and Margins](creating-and-setting-guides-and-margins.md)
19+
The **Guide Settings** dialog box has the following properties:
2020

21-
- [Aligning Controls on a Guide](../windows/aligning-controls-on-a-guide.md)
21+
|Property|Description|
22+
|---|---|
23+
|**Layout guides**|Displays the settings for the layout guides.|
24+
|**None**|Hides layout tools.|
25+
|**Rulers and guides**|When enabled, adds rulers to the layout tools; guides can be placed in the rulers. The default guides are the margins, which can be moved by dragging. Select the rulers to place a guide. Controls "snap" to guides when the controls are moved over or next to them. Controls also move with a guide once they're attached to it. When a control is attached to a guide on each side, and a guide is moved, the control is resized.|
26+
|**Grid**|Creates a layout grid. New controls will automatically align to the grid.|
27+
|**Grid spacing**|Displays the settings for the grid spacing in dialog box units (DLUs).|
28+
|**Width: DLUs**|Sets the width of the layout grid in DLUs. A horizontal DLU is the average width of the dialog box font divided by four.|
29+
|**Height: DLUs**|Sets the height of the layout grid in DLUs. A vertical DLU is the average height of the dialog box font divided by eight.|
2230

23-
- [Disabling Guides](../windows/disabling-guides.md)
31+
For information on adding resources to managed projects, see [Resources in Desktop Apps](/dotnet/framework/resources/index) in the *.NET Framework Developer's Guide*. For information on manually adding resource files to managed projects, accessing resources, displaying static resources, and assigning resource strings to properties, see [Creating Resource Files for Desktop Apps](/dotnet/framework/resources/creating-resource-files-for-desktop-apps). For information on globalization and localization of resources in managed apps, see [Globalizing and Localizing .NET Framework Applications](/dotnet/standard/globalization-localization/index).
2432

25-
- [Modifying the Layout Grid](../windows/modifying-the-layout-grid.md)
33+
## Create and set guides and margins
2634

27-
For information on adding resources to managed projects, please see [Resources in Desktop Apps](/dotnet/framework/resources/index) in the *.NET Framework Developer's Guide*. For information on manually adding resource files to managed projects, accessing resources, displaying static resources, and assigning resource strings to properties, see [Creating Resource Files for Desktop Apps](/dotnet/framework/resources/creating-resource-files-for-desktop-apps). For information on globalization and localization of resources in managed apps, see [Globalizing and Localizing .NET Framework Applications](/dotnet/standard/globalization-localization/index).
35+
Whether you're moving controls, adding controls, or rearranging a current layout, guides can help you align controls accurately within a dialog box. Guides appear as blue dotted lines across the dialog box displayed in the editor and corresponding arrows in the rulers (at the top and along the left side of the **Dialog** editor).
36+
37+
When you create a dialog box, four margins are provided. Margins are modified guides, appearing as blue dotted lines.
38+
39+
### To create a guide
40+
41+
1. Within the ruler, click once to create a guide. (One click creates a new guide; double-clicking launches the **Guide Settings** dialog box in which you can specify guide settings.)
42+
43+
### To set a guide
44+
45+
1. On the dialog box, click the guide and drag it to a new position. (You can also click the arrow in the ruler to drag the associated guide.)
46+
47+
The coordinates of the guide are displayed in the status bar at the bottom of the window and in the ruler. Move the pointer over the arrow in the ruler to display the exact position of the guide.
48+
49+
### To delete a guide
50+
51+
1. Drag the guide out of the dialog box.
52+
53+
\- or -
54+
55+
Drag the corresponding arrow off the ruler.
56+
57+
### To move margins
58+
59+
1. Drag the margin to the new position.
60+
61+
To make a margin disappear, move the margin to a zero position. To bring back the margin, place the pointer over the margin's zero position and move the margin into position.
62+
63+
## Align controls on a guide
64+
65+
The sizing handles of controls snap to guides when the controls are moved, and guides snap to controls (if there are no controls previously snapped to the guide). When a guide is moved, controls that are snapped to it move as well. Controls snapped to more than one guide are resized when one of the guides is moved.
66+
67+
The tick marks in the rulers that determine the spacing of guides and controls are defined by dialog units (DLUs). A DLU is based on the size of the dialog box font, normally 8-point MS Shell Dlg. A horizontal DLU is the average width of the dialog box font divided by four. A vertical DLU is the average height of the font divided by eight.
68+
69+
### To size a group of controls with guides
70+
71+
1. Snap one side of the control (or controls) to a guide.
72+
73+
1. Drag a guide to the other side of the control (or controls).
74+
75+
If necessary with multiple controls, size each to snap to the second guide.
76+
77+
1. Move either guide to size the control (or controls).
78+
79+
### To change the intervals of the tick marks
80+
81+
1. From the **Format** menu, choose **Guide Settings**.
82+
83+
1. In the **Guide Settings** dialog box, in the **Grid Spacing** field, specify a new width and height in DLUs.
84+
85+
## Disable guides
86+
87+
You can use special keys in conjunction with the mouse to disable the snapping effect of the guides. Using the **Alt** key disables the snapping effects of the guide selected. Moving a guide with the **Shift** key prevents snapped controls from moving with the guide.
88+
89+
### To disable the snapping effect of the guides
90+
91+
1. Drag the control while holding down the **Alt** key.
92+
93+
### To move guides without moving the snapped controls
94+
95+
1. Drag the guide while holding down the **Shift** key.
96+
97+
### To turn off the guides
98+
99+
1. From the **Format** menu, choose **Guide Settings**.
100+
101+
1. In the **Guide Settings** dialog box, under **Layout Guides**, select **None**.
102+
103+
> [!NOTE]
104+
> You can also double-click the ruler bar to access the **Guide Settings** dialog box.
105+
106+
\- or -
107+
108+
On the **Format** menu, select **Toggle Guides**.
109+
110+
## Modify the layout grid
111+
112+
When you're placing or arranging controls in a dialog box, you can use the layout grid for more precise positioning. When the grid is turned on, controls appear to "snap to" the dotted lines of the grid as if magnetized. You can turn this "snap to grid" feature on and off and change the size of the layout grid cells.
113+
114+
### To turn the layout grid on or off
115+
116+
1. From the **Format** menu, choose **Guide Settings**.
117+
118+
1. In the **Guide Settings** dialog box, select or clear the **Grid** button.
119+
120+
You can still control the grid in individual **Dialog** editor windows using the **Toggle Grid** button on the [Dialog Editor Toolbar](../windows/showing-or-hiding-the-dialog-editor-toolbar.md).
121+
122+
### To change the size of the layout grid
123+
124+
1. From the **Format** menu, choose **Guide Settings**.
125+
126+
1. In the **Guide Settings** dialog box, type the height and width in DLUs for the cells in the grid. The minimum height or width is 4 DLUs. For more information on DLUs, see [The Arrangement of Controls on Dialog Boxes](../windows/arrangement-of-controls-on-dialog-boxes.md).
28127

29128
## Requirements
30129

31130
Win32
32131

33-
## See Also
132+
## See also
34133

35134
[Arrangement of Controls on Dialog Boxes](../windows/arrangement-of-controls-on-dialog-boxes.md)<br/>
36135
[Controls in Dialog Boxes](../windows/controls-in-dialog-boxes.md)<br/>
37-
[Controls (MFC)](../mfc/controls-mfc.md)
136+
[Controls (MFC)](../mfc/controls-mfc.md)<br/>

‎docs/windows/disabling-guides.md‎

Lines changed: 0 additions & 41 deletions
This file was deleted.

0 commit comments

Comments
 (0)