LayoutMode Property

Gets or sets a value that indicate the section's flow direction.

Syntax

Visual Basic (Declaration)
Visual Basic (Usage)
C#

<DefaultValueAttribute()>
<SRCategoryAttribute("Layout")>
<LocalizableAttribute(True)>
<SRDescriptionAttribute("Indicates the section's flow direction.")>
Public Property LayoutMode As LayoutMode

Dim instance As Template
Dim value As LayoutMode
 
instance.LayoutMode = value
 
value = instance.LayoutMode

[DefaultValue()]
[SRCategory("Layout")]
[Localizable(true)]
[SRDescription("Indicates the section's flow direction.")]
public LayoutMode LayoutMode {get; set;}

Property Value

One of the LayoutMode values. The default is LayoutMode.TopToBottom

Remarks

When the template's LayoutMode is LayoutMode.LeftToRight, there are special policies compared to the common grid. Refer to the following list.

Column and Row concept may be switched.
- RowXXX actually means ColumnXXX in the users view point.
  
  For example:
  - AllowUserToAddRows is "AllowUserToAddColumn" in the user view point.
  - RowIndex in eventArgs is "ColumnIndex" in user view point.
  - ...
- ColumnXXX actually means RowXXX.
  
  For example:
  - ColumnHeader is "RowHeader" area in user view point.
  - PagingMode.MultiColumns is "MultiRows" in user view point.
  - ...
- Some columns or rows stay the same.
  
  For example:
  - ViewportRowIndex still means the viewport index in the row direction.
  - ViewportColumnIndex still means the viewport index in the column direction.
  - ColumnCount in RadioGroupCell still means "column count" of radio buttons.
Properties meanings may change.
- PrintSettings.HorizontalPageBreak actually means VerticalPageBreak.
- GcMultiRow.FreezeBottomRowCount actually means FreezeRightRowCount.
- GcMultiRow.FreezeTopRowCount actually means FreezeLeftRowCount.
- GcMultiRow.FreezeLeftCellIndex actually means FreezeTopCellIndex.
- GcMultiRow.FreezeRightCellIndex actually means FreezeBottomCellIndex.
- GcMultiRow.FreezeLeftCellName actually means FreezeTopCellName.
- GcMultiRow.FreezeRightCellName actually means FreezeBottomCellName.
- PrintSettings.AutoFitWidth actually means AutoFitHeight.
- NewRowPosition.Top actually means Left.
- NewRowPosition.Bottom actually means Right.
- LastRowPosition.Top actually means Left.
- LastRowPosition.Bottom actually means Right.
Certain properties may need to be changed since the default property value is not useful.
- RowHeaderCell's HoverDirection default is HoverDirection.Right, but when using LayoutMode.LeftToRight, HoverDirection.Bottom is better.
- RowHeaderCell's Cell.ResizeMode default is ResizeMode.Vertical, but when using LayoutMode.LeftToRight, ResizeMode.Horizontal is better.
- ColumnHeaderCell's HoverDirection default is HoverDirection.Bottom, but when using LayoutMode.LeftToRight, HoverDirection.Right is better.
- ColumnHeaderCell's Cell.ResizeMode default is ResizeMode.Horizontal, but when using LayoutMode.LeftToRight, ResizeMode.Vertical is better.
- ColumnHeaderCell's DefaultHeight is 20 but other cells are 21.
The default ShortcutKeys setting may need to be changed.
- By default, Ctrl+Up is set to MoveToFirstRow action. So, in ColumnMode, if the user press Ctrl + Up, the cell moves to the left most cell.
  
  To avoid this problem, use code to reassign the shortcut keys in the Form.Load event using ShortcutKeyManager.Register and ShortcutKeyManager.Unregister methods.

Requirements

Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

Reference

Template Class
Template Members