Infragistics logo
메뉴
.NET and JavaScript UI Controls
Version

MonthScrollChange Property

Returns or sets the number of months by which the control is scrolled when the month scroll buttons are clicked by the end user.
Syntax
'Declaration
 
Public Property MonthScrollChange As Integer
public int MonthScrollChange {get; set;}
Remarks

The MonthScrollChange property behaves exactly the same as the ScrollChange property did in previous versions. Since the addition of the YearScrollChange property, however, the existing name became somewhat ambiguous and as such was replaced by the new MonthScrollChange.

While the MonthScrollChange property applies specifically to the month scroll buttons, the ScrollChange property now applies to both the month scroll buttons and the year scroll buttons. When explicitly set, the value of the MonthScrollChange property takes precedence over the less specific ScrollChange property.

Example
The following code sample demonstrates how to use the properties of the UltraMonthViewMulti control to control the behavior and appearance of the month and year scroll buttons:

Imports Infragistics.Win
Imports Infragistics.Win.UltraWinSchedule

    Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles MyBase.Load
        '	Make the month and year scroll buttons visible
        Me.ultraMonthViewMulti1.MonthScrollButtonsVisible = DefaultableBoolean.True
        Me.ultraMonthViewMulti1.YearScrollButtonsVisible = DefaultableBoolean.True

        '	Assign different background colors to the month and year scroll buttons,
        '	and suppress theming for both
        Me.ultraMonthViewMulti1.MonthScrollButtonAppearance.BackColor = Color.LightBlue
        Me.ultraMonthViewMulti1.YearScrollButtonAppearance.BackColor = Color.LightGreen
        Me.ultraMonthViewMulti1.ScrollButtonAppearance.ThemedElementAlpha = Alpha.Transparent

        '	Resolve the MonthScrollButtonAppearance and use the same background color
        '	for the associated command button.
        Dim appearanceData As AppearanceData = New AppearanceData()
        Dim requestedProps As AppearancePropFlags = AppearancePropFlags.BackColor
        Me.ultraMonthViewMulti1.ResolveMonthScrollButtonAppearance(appearanceData, requestedProps)
        Me.cmdMonth.BackColor = appearanceData.BackColor

        '	Resolve the YearScrollButtonAppearance and use the same background color
        '	for the associated command button.
        appearanceData = New AppearanceData()
        requestedProps = AppearancePropFlags.BackColor
        Me.ultraMonthViewMulti1.ResolveYearScrollButtonAppearance(appearanceData, requestedProps)
        Me.cmdYear.BackColor = appearanceData.BackColor

        '	Set the MonthScrollChange property to 2 so that the control is scrolled
        '	by 2 months when the month scroll buttons are clicked
        Me.ultraMonthViewMulti1.MonthScrollChange = 2

        '	Set the YearScrollChange property to 5 so that the control is scrolled
        '	by 5 months when the year scroll buttons are clicked
        Me.ultraMonthViewMulti1.YearScrollChange = 5

        '	Set the visibility of the associated command buttons based on whether
        '	the month/year scroll buttons are visible in the control.
        Me.cmdMonth.Visible = Me.ultraMonthViewMulti1.MonthScrollButtonsVisibleResolved
        Me.cmdYear.Visible = Me.ultraMonthViewMulti1.YearScrollButtonsVisibleResolved

        '	Display the actual values of the MonthScrollChange/YearScrollChange properties
        '	in a TextBox.
        Me.txtMonthScrollChange.Text = String.Format("Actual value: {0}", Me.ultraMonthViewMulti1.MonthScrollChangeResolved)
        Me.txtYearScrollChange.Text = String.Format("Actual value: {0}", Me.ultraMonthViewMulti1.YearScrollChangeResolved)
    End Sub
using Infragistics.Win;
using Infragistics.Win.UltraWinSchedule;
using System.Diagnostics;

		private void Form1_Load(object sender, System.EventArgs e)
		{
			//	Make the month and year scroll buttons visible
			this.ultraMonthViewMulti1.MonthScrollButtonsVisible = DefaultableBoolean.True;
			this.ultraMonthViewMulti1.YearScrollButtonsVisible = DefaultableBoolean.True;

			//	Assign different background colors to the month and year scroll buttons,
			//	and suppress theming for both
			this.ultraMonthViewMulti1.MonthScrollButtonAppearance.BackColor = Color.LightBlue;
			this.ultraMonthViewMulti1.YearScrollButtonAppearance.BackColor = Color.LightGreen;
			this.ultraMonthViewMulti1.ScrollButtonAppearance.ThemedElementAlpha = Alpha.Transparent;

			//	Resolve the MonthScrollButtonAppearance and use the same background color
			//	for the associated command button.
			AppearanceData appearanceData = new AppearanceData();
			AppearancePropFlags requestedProps = AppearancePropFlags.BackColor;
			this.ultraMonthViewMulti1.ResolveMonthScrollButtonAppearance( ref appearanceData, ref requestedProps );
			this.cmdMonth.BackColor = appearanceData.BackColor;

			//	Resolve the YearScrollButtonAppearance and use the same background color
			//	for the associated command button.
			appearanceData = new AppearanceData();
			requestedProps = AppearancePropFlags.BackColor;
			this.ultraMonthViewMulti1.ResolveYearScrollButtonAppearance( ref appearanceData, ref requestedProps );
			this.cmdYear.BackColor = appearanceData.BackColor;

			//	Set the MonthScrollChange property to 2 so that the control is scrolled
			//	by 2 months when the month scroll buttons are clicked
			this.ultraMonthViewMulti1.MonthScrollChange = 2;

			//	Set the YearScrollChange property to 5 so that the control is scrolled
			//	by 5 months when the year scroll buttons are clicked
			this.ultraMonthViewMulti1.YearScrollChange = 5;

			//	Set the visibility of the associated command buttons based on whether
			//	the month/year scroll buttons are visible in the control.
			this.cmdMonth.Visible = this.ultraMonthViewMulti1.MonthScrollButtonsVisibleResolved;
			this.cmdYear.Visible = this.ultraMonthViewMulti1.YearScrollButtonsVisibleResolved;

			//	Display the actual values of the MonthScrollChange/YearScrollChange properties
			//	in a TextBox.
			this.txtMonthScrollChange.Text = string.Format("Actual value: {0}", this.ultraMonthViewMulti1.MonthScrollChangeResolved );
			this.txtYearScrollChange.Text = string.Format("Actual value: {0}", this.ultraMonthViewMulti1.YearScrollChangeResolved );
		}
Requirements

Target Platforms: Windows 10, Windows 8.1, Windows 8, Windows 7, Windows Server 2012, 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

See Also