| title | ms.custom | ms.date | ms.prod | ms.reviewer | ms.suite | ms.technology | ms.tgt_pltfrm | ms.topic | helpviewer_keywords | ms.assetid | caps.latest.revision | author | ms.author | manager | |||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Use Automatic Layout Overview |
03/30/2017 |
.net-framework |
|
article |
|
6fed9264-18bb-4d05-8867-1fe356c6f687 |
22 |
dotnet-bot |
dotnetcontent |
wpickett |
Use Automatic Layout Overview
This topic introduces guidelines for developers on how to write [!INCLUDETLA#tla_winclient] applications with localizable [!INCLUDETLA#tla_ui#plural]. In the past, localization of a [!INCLUDETLA2#tla_ui] was a time consuming process. Each language that the [!INCLUDETLA2#tla_ui] was adapted for required a pixel by pixel adjustment. Today with the right design and right coding standards, [!INCLUDETLA2#tla_ui#plural] can be constructed so that localizers have less resizing and repositioning to do. The approach to writing applications that can be more easily resized and repositioned is called automatic layout, and can be achieved by using [!INCLUDETLA2#tla_winclient] application design.
Advantages of Using Automatic Layout
Because the [!INCLUDETLA2#tla_winclient] presentation system is powerful and flexible, it provides the ability to layout elements in an application that can be adjusted to fit the requirements of different languages. The following list points out some of the advantages of automatic layout.
-
[!INCLUDETLA2#tla_ui] displays well in any language.
-
Reduces the need to readjust position and size of controls after text is translated.
-
Reduces the need to readjust window size.
-
[!INCLUDETLA2#tla_ui] layout renders properly in any language.
-
Localization can be reduced to the point that it is little more than string translation.
Automatic Layout and Controls
Automatic layout enables an application to adjust the size of a control automatically. For example, a control can change to accommodate the length of a string. This capability enables localizers to translate the string; they no longer need to resize the control to fit the translated text. The following example creates a button with English content.
[!code-xamlLocalizationBtn_snip#1]
In the example, all you have to do to make a Spanish button is change the text. For example,
[!code-xamlLocalizationBtn#1]
The following graphic shows the output of the code samples.
Automatic Layout and Coding Standards
Using the automatic layout approach requires a set of coding and design standards and rules to produce a fully localizable [!INCLUDETLA2#tla_ui]. The following guidelines will aid your automatic layout coding.
| Coding Standards | Description |
|---|---|
| Do not use absolute positions. | - Do not use xref:System.Windows.Controls.Canvas because it positions elements absolutely. - Use xref:System.Windows.Controls.DockPanel, xref:System.Windows.Controls.StackPanel, and xref:System.Windows.Controls.Grid to position controls. - For a discussion about various types of panels, see Panels Overview. |
| Do not set a fixed size for a window. | - Use xref:System.Windows.Window.SizeToContent%2A. - For example: [!code-xamlLocalizationGrid#2] |
| Add a xref:System.Windows.FrameworkElement.FlowDirection%2A. |
|
| Use composite fonts instead of physical fonts. |
|
| Add xml:lang. | - Add the xml:lang attribute in the root element of your [!INCLUDETLA2#tla_ui], such as xml:lang="en-US" for an English application.- Because composite fonts use xml:lang to determine what font to use, set this property to support multilingual scenarios. |
Automatic Layout and Grids
The xref:System.Windows.Controls.Grid element, is useful for automatic layout because it enables a developer to position elements. A xref:System.Windows.Controls.Grid control is capable of distributing the available space among its child elements, using a column and row arrangement. The [!INCLUDETLA2#tla_ui] elements can span multiple cells, and it is possible to have grids within grids. Grids are useful because they enable you to create and position complex [!INCLUDETLA2#tla_ui]. The following example demonstrates using a grid to position some buttons and text. Notice that the height and width of the cells are set to xref:System.Windows.GridUnitType.Auto; therefore, the cell that contains the button with an image adjusts to fit the image.
[!code-xamlLocalizationGrid#1]
The following graphic shows the grid produced by the previous code.
Automatic Layout and Grids Using the IsSharedSizeScope Property
A xref:System.Windows.Controls.Grid element is useful in localizable applications to create controls that adjust to fit content. However, at times you want controls to maintain a particular size regardless of content. For example, if you have "OK", "Cancel" and "Browse" buttons you probably do not want the buttons sized to fit the content. In this case the xref:System.Windows.Controls.Grid.IsSharedSizeScope%2A?displayProperty=nameWithType attached property is useful for sharing the same sizing among multiple grid elements. The following example demonstrates how to share column and row sizing data between multiple xref:System.Windows.Controls.Grid elements.
[!code-xamlgridIssharedsizescopeProp#2]
Note For the complete code sample, see Share Sizing Properties Between Grids
See Also
Globalization for WPF
Use Automatic Layout to Create a Button
Use a Grid for Automatic Layout

