ImageViewerクラスは、レイアウトを構築して、ビューと項目を提出するために、標準的なマージン、境界とパディングシステムを使います。
以下の具体例は、概念を説明します:
ビューは、すべての項目の累積的な領域さらにビュー境界とパディングの値です。
各項目のコンテンツは、その境界(具体例の灰色の部分)の内側の領域です。
最も外部の(プラットホームの型をパディングしているネイティブであるNotePadding
)ものから開始している以下の領域の画像ビューワレイアウト:
プロパティ | 型 | 説明 |
---|---|---|
ImageViewer.BorderStyle | プラットホーム BorderStyle |
それがビューワのクライアントエリアの外で横たわるため、これは標準的なプラットホーム |
ImageViewer.ViewMargin | Padding |
ビューワクライアント四角形の左上とビューワ境界の間の領域。 |
ImageViewer.ViewBorderThickness | 整数 |
ビュー境界の厚さ |
ImageViewer.ViewPadding | Padding |
ビュー境界と項目の間の領域 |
ImageViewer.ItemMargin | Padding |
項目の左上とパディングしているビュー間の領域 |
ImageViewer.ItemBorderThickness | 整数 |
項目長方形の厚さ |
ImageViewer.ItemPadding | Padding |
項目境界とimage間の領域 |
ImageViewer.ImageBorderThickness | 整数 |
image境界の厚さ |
ImageViewer.ItemSpacing | LeadSize |
隣接した項目の間のスペーシング。レイアウトに可視項目が複数存在する場合のみ使用されます。 |
上のすべての値がピクセルにあって、固定である点に現在のズーム値に関係なく注意します。
以下のテーブルは、各々の領域がどのように提出されるかについて示します。
Windows.Formsで注意します。制御背景色はImageViewerのSystem.Windows.Forms.Control.BackColorプロパティの値です
見方は、上のテーブルにリストされる要素の全ての累積的な領域がImageViewer.ViewMarginを受け取るということです:
パディングとマージンセットと2つの項目によるImageViewer。垂直を用いて、レイアウトを表示します。
ImageViewerは、スクロールバーの値を計算するために、ビューサイズを使います。レイアウトシステムによってピクセル単位で計算される総サイズは、リードオンリーのImageViewer.ViewSizeプロパティから得られることができます。バウンディング四角形(開始位置はクライアントエリアさらにビューマージンです)は、リードオンリーのImageViewer.ViewBoundsプロパティを使用して得られることができます。これらの2つの値は、総レイアウトサイズプラス現在のビュー変換に基づいて計算されます。
ビューは、以下のどれを用いてでも変形されることができます:
ScrollOffsetプロパティを更新するか、ScrollByまたはScrollByRestrictを使って、スクロールバーを用いて
Zoomメソッドを用いて中に、そして、外にビューをズームすること
RotateAngleプロパティを使用してビューを回転させること
フリッププロパティを使用して垂直にビューを上下に反転すること
逆のプロパティを使用して水平にビューをミラー化すること
すべてのこれらの操作はビュー(ViewSizeとViewBounds)を再計算して、スクロール領域を更新します。
ビューは、ViewHorizontalAlignmentとViewVerticalAlignmentを用いてビューの中に位置合わせされることができます。
ViewDropShadowプロパティは、ビュー境界のまわりでドロップシャドウを提出するのに用いられることができます。
ItemMargin:これは、項目(青境界の外で)の外の領域です
項目コンテンツ:灰色の部分
ItemPadding:コンテンツ(境界内で)とimage間の領域
各項目はサイズを持っています、これはImageViewer.ItemSizeプロパティ(たとえば画像ビューワがimageリストとして使われるとき)を使用してビューワですべての項目のために固定されることもできます。または、各項目は、imageが項目で設定されるとき、固定値に設定されることができるか、ビューワによって自動的に計算されることができるそれ自身の項目の大きさ(ImageViewerItem.Size)を持っていることができます。
項目は、ItemHorizontalAlignmentとItemVerticalAlignmentを用いてビューの中に位置合わせされることができます。
内部の各項目は、コンテンツ領域です。これは、画像データとオプションのテキストが提出されるところです。imageは、ImageHorizontalAlignmentとImageVerticalAlignmentを用いてコンテンツの中に位置合わせされます。これらの値はビューワですべての項目のためにイメージの位置合せを変更して、個々の項目使用イメージの位置合せImageViewerItem.ImageHorizontalAlignmentとImageViewerItem.ImageVerticalAlignmentを設定します。
項目がImageViewerItem.Textプロパティでテキスト文字列を格納するならば、画像ビューアーはItemTextFontとItemTextColor(または、項目が選択されるならばSelectedItemTextColor)を用いてこのテキストを生成します。ItemTextTrimmingとItemTextWrapは、そのサイズが境界ボックスを上回るならば、テキストがどのように提出されるかについて制御するのに必要に応じて用いられることができます。TextHorizontalAlignmentとTextVerticalAlignmentは、コンテンツの中にテキストを位置合わせするのに用いられることができます。上のイメージの位置合せと同様で、個々の項目を設定するために、テキスト配置は、ImageViewerItem.TextHorizontalAlignmentとImageViewerItem.TextVerticalAlignmentを使います。
ImageViewerItemPart列挙体が、興味があるアイテムの部分に寄与するために、メソッドとプロパティで使われることができます。
ImageDropShadowプロパティは、コンテンツの中にimage境界のまわりでドロップシャドウを提出するのに用いられることができます。
imageは、ビューのまわりで、または、以下を用いた各項目imageのまわりでドロップシャドウを提出することをサポートします:
メンバ | 説明 |
---|---|
ViewDropShadow |
ビューのドロップシャドウプロパティ。ビュー境界の外で、そして、ビューマージンの中に提出されます。それゆえに、ビューマージン値が目的のドロップシャドウサイズをカバーするのに十分大きいことを確実にしなければなりません。 |
ImageDropShadow |
項目イメージのドロップシャドウプロパティ。image境界の外で、そして、パディングしている項目の中に提出されます。それゆえに、値をパディングしている項目が目的のドロップシャドウサイズをカバーするのに十分大きいことを確実にしなければなりません。 |
これらのプロパティの各々は、型ControlDropShadowOptionsで、以下のメンバを持っています:
メンバ | 説明 |
---|---|
IsVisibleな |
ドロップシャドウで見える。この値がtrueでないならば、ドロップシャドウは提出されません |
カラー |
ドロップシャドウのカラー |
OffsetX |
水平が暗くなるという見解f |
OffsetY |
垂直方向のシャドウのposition |
ぼかし |
ぼかし距離 |