Orientation Property

Gets or sets the orientation of the track bar.

Syntax

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

<LocalizableAttribute(True)>
<SRCategoryAttribute("Appearance")>
<SRDescriptionAttribute("Indicates the orientation of the track bar.")>
<DefaultValueAttribute()>
Public Property Orientation As Orientation

Dim instance As TrackBarCell
Dim value As Orientation
 
instance.Orientation = value
 
value = instance.Orientation

[Localizable(true)]
[SRCategory("Appearance")]
[SRDescription("Indicates the orientation of the track bar.")]
[DefaultValue()]
public Orientation Orientation {get; set;}

Property Value

One of the System.Windows.Forms.Orientation values. The default is System.Windows.Forms.Orientation.Horizontal.

Exceptions

Exception	Description
System.ComponentModel.InvalidEnumArgumentException	The specified value is not a System.Windows.Forms.Orientation value.

Remarks

When the Orientation property is set to System.Windows.Forms.Orientation.Horizontal, the scroll box moves from left to right as the Cell.Value increases. When the Orientation property is set to System.Windows.Forms.Orientation.Vertical, the scroll box moves from bottom to top as the Cell.Value increases.

Example

The following code example shows a vertical TrackBarCell. The Minimum is 10 and the Maximum is 20. Press the up arrow or down arrow key and the bar moves two positions. Click the track bar and it moves five positions. There are two positions between each tick mark. This example is part of a larger example available for the TrackBarCell class.

private void Form1_Load(object sender, EventArgs e)
        {
            TrackBarCell trackBarCell1 = new TrackBarCell();
            trackBarCell1.Size = new Size(80, 80);
            //When the slider is dragged to the top, the Cell.FormattedValue is 20.
            trackBarCell1.Maximum = 20;
            //When the slider is dragged to the bottom, the Cell.FormattedValue is 10.
            trackBarCell1.Minimum = 10;
            //Press the Up or Down key, 2 positions are moved.
            trackBarCell1.SmallChange = 2;
            //Click on  the track bar, 5 positions are moved.
            trackBarCell1.LargeChange = 5;
            //Between each tick mark, there are 2 positions.
            trackBarCell1.TickFrequency = 2;

            TrackBarCell trackBarCell2 = trackBarCell1.Clone() as TrackBarCell;
            //Track bar has a vertical orientation.
            trackBarCell2.Orientation = Orientation.Vertical;
            trackBarCell2.TickStyle = TickStyle.Both;

            Template template1 = Template.CreateGridTemplate(new Cell[] { trackBarCell1, trackBarCell2 });

            gcMultiRow1.Template = template1;
            gcMultiRow1.RowCount = 3;
        }

VB.NET

Private Sub Form1_Load(ByVal sender As Object, ByVal e As EventArgs) Handles Me.Load
        Dim trackBarCell1 As New TrackBarCell()
        trackBarCell1.Size = New Size(80, 80)
        'When the slider is dragged to the top, the Cell.FormattedValue is 20.
        trackBarCell1.Maximum = 20
        'When the slider is dragged to the bottom, the Cell.FormattedValue is 10.
        trackBarCell1.Minimum = 10
        'Press the Up or Down key, 2 positions are moved.
        trackBarCell1.SmallChange = 2
        'Click on  the track bar, 5 positions are moved.
        trackBarCell1.LargeChange = 5
        'Between each tick mark, there are 2 positions.
        trackBarCell1.TickFrequency = 2

        Dim trackBarCell2 = TryCast(trackBarCell1.Clone(), TrackBarCell)

        'Track bar has a vertical orientation.
        trackBarCell2.Orientation = Orientation.Vertical
        trackBarCell2.TickStyle = TickStyle.Both

        Dim template1 As Template = Template.CreateGridTemplate(New Cell() {trackBarCell1, trackBarCell2})

        gcMultiRow1.Template = template1
        gcMultiRow1.RowCount = 3
    End Sub

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

TrackBarCell Class
TrackBarCell Members