'宣言 Public Class UltraScrollBar Inherits Infragistics.Win.UltraControlBase Implements Infragistics.Win.AppStyling.ISupportAppStyling, Infragistics.Win.IUltraControl, Infragistics.Win.IUltraControlElement, Infragistics.Win.Touch.ISupportTouchMetrics, Infragistics.Win.UIAutomation.IProvideUIAutomation
UltraScrollBar コントロールは、組み込み ScrollBar のすべての機能と複数の他の機能を提供します。Presentation Layer Framework の利点 (コントロールの側面をオーナーが描画する能力、ひとつのプロパティInfragistics.Win.UltraControlBase.FlatMode 設定、アルファブレンディングのサポート、およびキーボード マッピングを含む) に加えて、コントロールは UltraScrollBar のルック アンド フィールをカスタマイズするための追加プロパティを公開します。スクロールバー全体、スクロール つまみ、スクロール ボタンおよびスクロール トラックの外観を制御するための 4 種類の外観プロパティがあります。MinMaxButtonsVisible によって、Minimum および Maximum 値に移動するためのボタンを提供できます。スクロール ボタンの数と配置は、ScrollBarArrowStyle を使用して制御できます。
UltraScrollBar は追加プロパティも提供し、より簡単にコントロールを使用できるようにします。AutoSize プロパティは、コントロールがシステム スクロール バー設定と同じサイズを維持するために使用できます。AutoDisable プロパティは、スクロール ボックスが移動できない場合に、コントロール レンダラーを無効にするために使用できます。UseDefaultContextMenu は、Windows システムの ScrollBar と同様のスクロール バーにコンテキスト メニューを提供するために使用できます。
コントロールの設定を容易にするために、Initialize および GetMaximumDragValue メソッドと MaximumDragValue プロパティが追加されました。
Imports Infragistics.Win Imports Infragistics.Win.UltraWinScrollBar Private Sub InitializeScrollBar() With Me.ultraScrollBar1 ' Note: Under Windows XP if the 'SupportThemes' property ' is left set to True (its default setting) then some of ' the explicit appearance and button style property ' settings are ignored. .SupportThemes = False ' Set the appearance of the scroll bar control ' to use a gradient. .Appearance.BackColor = Color.LightGray .Appearance.BackColor2 = Color.White .Appearance.BackGradientStyle = GradientStyle.HorizontalBump .Appearance.ForeColor = Color.Red ' Specify the appearance of the scroll buttons .ButtonAppearance.BackColor = Color.LightGray .ButtonAppearance.BackGradientStyle = GradientStyle.None .ButtonAppearance.ForeColor = Color.Red ' Specify the appearance of the scroll thumb track area .TrackAppearance.BackColor = Color.Gray ' Specify the appearance of the scroll thumb .ThumbAppearance.BackColor = Color.Silver .ThumbAppearance.BackColor = Color.Silver .ThumbAppearance.BackGradientStyle = GradientStyle.None .ThumbAppearance.BackHatchStyle = BackHatchStyle.Divot ' Specify that the scrollbar will be automatically ' disabled when the Minimum, Maximum and LargeChange ' values don't permit thumb movement. .AutoDisable = True ' Specify that the control will be sized automatically ' based on its 'Orientation'. .AutoSize = True ' Set the button style for the control .ButtonStyle = UIElementButtonStyle.Button3D ' Set the 'Minimum', 'Maximum', 'LargeChange' and ' 'SmallChange' properties. .Minimum = 45 .Maximum = 85 .SmallChange = 1 .LargeChange = 5 ' Note: Instead of setting the individual 4 properties ' above you can call the 'Initialize' method and pass ' the values in as parameters. .Initialize(45, 80, 1, 5) ' Notice, however that the 2nd paramter ('maximumDragValue') ' is not the same value we set the 'Maximum' property above. ' ' The 'Initialize' method takes into account the value ' of the 'largeChange' parameter and adds that into the ' 'Maximum' property. In this example the highest 'Value' ' that can be attained is 80 even though 'Maximum' is ' set to 85. ' Initialize the value property .Value = 45 ' Set the orientation of the control to be vertical. .Orientation = Orientation.Vertical ' Specify that 2 additional buttons will be ' shown, one to go to the minimum value (left/top) ' and one to go to the maximum value (right/bottom). .MinMaxButtonsVisible = True ' Specify where the buttons appear. ' Note: This enumeration has a 'None' option to ' hide the buttons. .ScrollBarArrowStyle = ScrollBarArrowStyle.BothAtLeftTop ' If this property is set to true right clicking ' on the scrollbar will display a context menu ' with various scrolling options. .UseDefaultContextMenu = True End With End Sub
using Infragistics.Win; using Infragistics.Win.UltraWinScrollBar; private void InitializeScrollBar() { UltraScrollBar sbar = this.ultraScrollBar1; // Note: Under Windows XP if the 'SupportThemes' property // is left set to True (its default setting) then some of // the explicit appearance and button style property // settings are ignored. sbar.SupportThemes = false; // Set the appearance of the scroll bar control // to use a gradient. sbar.Appearance.BackColor = Color.LightGray; sbar.Appearance.BackColor2 = Color.White; sbar.Appearance.BackGradientStyle = GradientStyle.HorizontalBump; sbar.Appearance.ForeColor = Color.Red; // Specify the appearance of the scroll buttons sbar.ButtonAppearance.BackColor = Color.LightGray; sbar.ButtonAppearance.BackGradientStyle = GradientStyle.None; sbar.ButtonAppearance.ForeColor = Color.Red; // Specify the appearance of the scroll thumb track area sbar.TrackAppearance.BackColor = Color.Gray; // Specify the appearance of the scroll thumb sbar.ThumbAppearance.BackColor = Color.Silver; sbar.ThumbAppearance.BackColor = Color.Silver; sbar.ThumbAppearance.BackGradientStyle = GradientStyle.None; sbar.ThumbAppearance.BackHatchStyle = BackHatchStyle.Divot; // Specify that the scrollbar will be automatically // disabled when the Minimum, Maximum and LargeChange // values don't permit thumb movement. sbar.AutoDisable = true; // Specify that the control will be sized automatically // based on its 'Orientation'. sbar.AutoSize = true; // Set the button style for the control sbar.ButtonStyle = UIElementButtonStyle.Button3D; // Set the 'Minimum', 'Maximum', 'LargeChange' and // 'SmallChange' properties. sbar.Minimum = 45; sbar.Maximum = 85; sbar.SmallChange = 1; sbar.LargeChange = 5; // Note: Instead of setting the individual 4 properties // above you can call the 'Initialize' method and pass // the values in as parameters. sbar.Initialize(45, 80, 1, 5); // Notice, however that the 2nd paramter ('maximumDragValue') // is not the same value we set the 'Maximum' property above. // // The 'Initialize' method takes into account the value // of the 'largeChange' parameter and adds that into the // 'Maximum' property. In this example the highest 'Value' // that can be attained is 80 even though 'Maximum' is // set to 85. // Initialize the value property sbar.Value = 45; // Set the orientation of the control to be vertical. sbar.Orientation = Orientation.Vertical; // Specify that 2 additional buttons will be // shown, one to go to the minimum value (left/top) // and one to go to the maximum value (right/bottom). sbar.MinMaxButtonsVisible = true; // Specify where the buttons appear. // Note: This enumeration has a 'None' option to // hide the buttons. sbar.ScrollBarArrowStyle = ScrollBarArrowStyle.BothAtLeftTop; // If this property is set to true right clicking // on the scrollbar will display a context menu // with various scrolling options. sbar.UseDefaultContextMenu = true; }