(Leadtools.Controls)

フレームを表示

ScrollModeプロパティ




現在の変換がコントロールより大きい表示領域に終わるとき、コントロールがどのようにスクロールバーを処理するか決定します。
構文
public virtual ControlScrollMode ScrollMode {get; set;}
'Declaration
 
Public Overridable Property ScrollMode As ControlScrollMode

属性値

スクロールモード。デフォルト値は、ControlScrollMode.Autoです。
解説

このプロパティの値を変更すると、PropertyChangedとTransformChangedイベントが発生します。

表示領域のサイズは、ビューワの内側の項目のサイズに従う制御サイズ、ビューレイアウトと現在の変換より大きいかより小さくなるかもしれません。この場合、コントロールは、スクロールバーを示すか、非表示にして、パニングを処理する方法を決定するために必要かもしれません。

他のスクロールモデルの場合と同様に、現在のスクロールオフセットの値と最大スクロール領域のサイズを調べて、その値を変更できます。これらは、このコントロールのScrollOffsetMaximumScrollSizeプロパティで保存されます。

RestrictScrollの値は、スクロールモードがControlScrollMode.Hiddenに設定されるならばユーザーが最大のスクロールエリア(MaximumScrollSize)の外でimageをパンしようとするとき、何をするべきか決定します。

コントロールがどのようにスクロールバーを処理するか決定するために、ScrollModeの値を使います:

説明
ControlSizeMode.Auto

これは、実際のプラットホームスクロールバーを使うために、コントロールを指示します。ビューワは、変換とイメージサイズ値に従いスクロールバーを示して、非表示にします。これは、デフォルト動作です。RestrictScrollの値がこの場合使われません、そして、ユーザーは最大のスクロールエリアの外でパンすることができません。0,0から、ScrollOffsetまたはScrollByを使用することにより許可される最大値(MaximumScrollSize)まで画像を手動でスクロールおよびパンできます。

注意:いくつかのプラットホームは、モバイルおよびタブレットブラウザなどの、スクロールバーをサポートしません。このようなプラットフォームでは、ControlScrollMode.Autoを指定しても実際にはスクロールバーは表示されません。代わりに、それは、trueScrollModeControlScrollMode.HiddenRestrictScrollに設定するのと同じ動作を持っています。

ControlSizeMode.Hidden

これは、実際のスクロールバーを使わずにスクロールを有効にするために、コントロールを指示します。変換値がたとえ何であろうとも、ビューワはスクロールバーを示しません。0,0から、ScrollOffsetまたはScrollByを使用することにより許可される最大値(MaximumScrollSize)まで画像を手動でスクロールおよびパンできます。または、必要であれば、RestrictScrollの値をtrueに設定して、規制なしで任意の値へのimageをスクロールするか、パンします。

ControlSizeMode.Disabled

これは、完全にスクロールを無効にするために、ビューワを指示します。スクロールバーは現在の変換とイメージサイズに関係なく決して見えないでしょう、そして、ScrollOffsetに設定されるか、ScrollByに渡される任意の値は無視されます。設定RestrictScrollは使用しません。

彼は、ユーザーがスクロールするか、範囲の外でパンしようとするならば、起こることをRestrictScrollコントロールの評価します。RestrictScrollの値がtrue(デフォルト)である場合、ユーザーは最大スクロール領域の範囲を超えてスクロール/パンすることはできません。これは、スクロールバーが表示されないこと以外はControlScrollMode.Autoと同じように機能します。RestrictScrollの値がfalseに設定されるならば、ユーザーは許可する無制限のパニングです、そして、ScrollOffsetまたはScrollByのスクロール、任意の値が使われることができます(負の数、非常に大きな値)。これは、マッピングまたは医療用途のように状況によっては役に立つかもしれません。

注意:ScrollModeの値を変更することは、ScrollOffsetの値に影響を及ぼすかもしれません。たとえば、スクロールモードがControlScrollMode.Hiddenで、RestrictScrollがfalseに設定されている場合、ユーザーは最大スクロール範囲を超えて画像をパンできます(この場合では不正)。ここで、ScrollModeControlScrollMode.Autoに設定されるならば、スクロールオフセットは領域をスクロールしている最大限の外側にあることができません、そして、ビューワは現在のモードのために最も近い法的値にScrollOffsetの値を変更します。ユーザーがtruefalseからRestrictScrollの値を変更するとき、これも適用できます。

詳細については、「画像ビューワのスクローリング」を参照してください。

サンプル

デモを実行します。ここで例ボタンをクリックするとき、スクロールモード意志トグルスイッチ。

ImageViewerサンプルからサンプル関数内のコードをすべて削除し("// TODO:ここにサンプルコードを追加します"というコメントを検索する)、以下のコードを挿入します。

Copy Code  
Imports Leadtools
Imports Leadtools.Controls
Imports Leadtools.Codecs
Imports Leadtools.Drawing
Imports Leadtools.ImageProcessing
Imports Leadtools.ImageProcessing.Color

If _imageViewer.ScrollMode <> ControlScrollMode.Hidden Then
   _imageViewer.ScrollMode = ControlScrollMode.Hidden
   _imageViewer.RestrictScroll = False
End If
using Leadtools;
using Leadtools.Controls;
using Leadtools.Codecs;
using Leadtools.Drawing;
using Leadtools.ImageProcessing;
using Leadtools.ImageProcessing.Color;

if (_imageViewer.ScrollMode != ControlScrollMode.Hidden)
{
   _imageViewer.ScrollMode = ControlScrollMode.Hidden;
   _imageViewer.RestrictScroll = false;
}
必要条件

ターゲットプラットホーム

参照

参照

ImageViewerクラス
ImageViewerメンバ