GrapeCity MultiRow for Windows Forms 11.0J
ズーム

MultiRowはピンチとストレッチによってグリッドの内容をズームできます。ここでは、タッチ操作によるグリッドのズーム機能について解説します。




最小ズーム倍率の設定
MinZoomFactorプロパティを使用すると、最小のズーム倍率を設定できます。ピンチで最小ズーム倍率より小さくズームした場合、画面はバウンドしてMinZoomFactorプロパティで設定したズーム倍率で表示します。



次のコードでは、最小ズーム倍率を100%に設定します。
GcMultiRow1.MinZoomFactor = 1.0F
gcMultiRow1.MinZoomFactor = 1.0F;
スナップポイントの追加
TouchZoomSnapPointsプロパティを使用するとズームのスナップポイントを設定できます。スナップポイントを設定している場合、ピンチまたはストレッチの操作を中断して画面から指を離したときに最も近いスナップポイントにズーム倍率が自動で設定されます。

スナップポイントを追加するには、次のように操作します。

  1. GcMultiRowコントロールを選択する。(例: gcMultiRow1)
  2. プロパティウィンドウでTouchZoomSnapPointsプロパティを選択し、[...]ボタンをクリックする。
  3. 表示されたSingleコレクションエディタで[追加]ボタンをクリックする。
  4. メンバーに追加された項目を選択し、画面右のプロパティグリッドのValueプロパティに0から4の範囲で任意の値を追加する。
  5. [OK]ボタンをクリックしてSingleコレクションエディタを閉じる。



また、コードでスナップポイントを追加することができます。スナップポイントを追加するにはAddメソッドまたはAddRangeメソッドを使用します。
' Addメソッドでズーム倍率のスナップポイントを追加します。
GcMultiRow1.TouchZoomSnapPoints.Add(1.5F)
GcMultiRow1.TouchZoomSnapPoints.Add(2.0F)
GcMultiRow1.TouchZoomSnapPoints.Add(2.5F)

' AddRangeメソッドでズーム倍率のスナップポイントを追加します。
GcMultiRow1.TouchZoomSnapPoints.AddRange(New Single() {3.0F, 3.5F})
// Addメソッドでズーム倍率のスナップポイントを追加します。
gcMultiRow1.TouchZoomSnapPoints.Add(1.5F);
gcMultiRow1.TouchZoomSnapPoints.Add(2F);
gcMultiRow1.TouchZoomSnapPoints.Add(2.5F);

// AddRangeメソッドでズーム倍率のスナップポイントを追加します。
gcMultiRow1.TouchZoomSnapPoints.AddRange(new float[] { 3F, 3.5F });


スナップポイントによるズーム倍率の自動設定機能が実行されるには TouchZoomSnapDistanceプロパティに設定した値よりも大きくズームする必要があります。例えば、TouchZoomSnapDistanceプロパティに1が設定されている場合、1回のピンチまたはストレッチの操作で100%以上のズーム倍率を変更させないと、スナップポイントによるズーム倍率の自動設定機能は実行されません。



' ズーム倍率が50%以上変更されたときにズーム倍率の自動設定が行われるようにします。
GcMultiRow1.TouchZoomSnapDistance = 0.5F
// ズーム倍率が50%以上変更されたときにズーム倍率の自動設定が行われるようにします。
gcMultiRow1.TouchZoomSnapDistance = 0.5F;
ズームの禁止
AllowUserToTouchZoomプロパティにFalseを設定すると、タッチ操作でのズームを禁止します。タッチ操作でのズームを禁止することで、スクロール操作などで誤ってズームしてしまうことを抑止できます。
GcMultiRow1.AllowUserToTouchZoom = False
gcMultiRow1.AllowUserToTouchZoom = false;
   
関連トピック

 

 


© 2008 GrapeCity inc. All rights reserved.