基本的な使い方

ここでは、コントロールバーとC1ZoomCommandProviderコンポーネントの基本的な使用方法について解説します。

コントロールバー

C1Zoom コンポーネントが配置されているフォームでは、ズームやスクロールの操作をエンドユーザーの目に触れる形で提供するコントロールバーを表示することができます。コントロールバーは、ユーザーコントロールで作成され、C1Zoom.ControlBars プロパティが参照するControlBar オブジェクトのコレクションに追加することで定義されます。

ユーザーコントロールに配置されたボタン等に拡大、縮小、スクロールといったタッチ操作のコマンドを設定するには、C1ZoomCommandProvider コンポーネントを使用します。

コントロールバーの詳細な作成方法については「コントロールバー」を参照してください。

組み込みのアクション

C1ZoomCommandProvider コンポーネントでは、次の組み込みのアクションを提供します。

定義	説明
None	どのコマンドも実行しません（デフォルト値）。
ZoomIn	このコマンドを実行すると、10% ズームインします。現在のズーム率が最大ズーム率に達している場合は何もしません。
ZoomOut	このコマンドを実行すると、10% ズームアウトします。現在のズーム率が最小ズーム率に達している場合は何もしません。
ResetZoom	ズーム率を100%にします。
ScrollLeft	フォームコンテンツの幅の 1/3 だけ左にスクロールします。フォームがスクロールの終端に達している場合は何もしません。
ScrollRight	フォームコンテンツの幅の 1/3 だけ右にスクロールします。フォームがスクロールの終端に達している場合は何もしません。
ScrollUp	フォームコンテンツの高さの 1/3 だけ上にスクロールします。フォームがスクロールの終端に達している場合は何もしません。
ScrollDown	フォームコンテンツの高さの 1/3 だけ下にスクロールします。フォームがスクロールの終端に達している場合は何もしません。
SwitchFullScreen	フォームをフルスクリーンに変更します。フォームがすでにフルスクリーンになっている場合は、元に戻します。
ShowOrHidePreviewWindow	パンウィンドウを表示します。パンウィンドウがすでに表示されている場合は、パンウィンドウを閉じます。
SelectNextControl	アクティブなコントロールを次に移動します。
SelectPreviousControl	アクティブなコントロールを前に移動します。

ユーザー定義のアクション

C1ZoomCommandProvider.OwnerForm プロパティを通じて、コントロールバーが表示されるフォームにアクセスできます。次のコードはフォームを閉じる処理です。

Visual Basic	コードのコピー
C1ZoomCommandProvider1.OwnerForm.Close()

C#	コードのコピー
C1ZoomCommandProvider1.OwnerForm.Close();

C1ZoomCommandProvider.OwnerC1Zoom プロパティを通じて、コントロールバーが表示されるフォーム上のC1Zoom コンポーネントにアクセスできます。次のコードは、ズームしたフォームで右下に向かってスクロールします。

Visual Basic	コードのコピー
Private Sub Button1_Click(sender As Object, e As EventArgs) Handles Button1.Click Dim currentLocation As Point = C1ZoomCommandProvider1.OwnerC1Zoom.ScrollLocation currentLocation.X -= 100 currentLocation.Y -= 100 C1ZoomCommandProvider1.OwnerC1Zoom.ScrollLocation = currentLocation End Sub

Visual Basic

コードのコピー

Private Sub Button1_Click(sender As Object, e As EventArgs) Handles Button1.Click
    Dim currentLocation As Point = C1ZoomCommandProvider1.OwnerC1Zoom.ScrollLocation
    currentLocation.X -= 100
    currentLocation.Y -= 100
    C1ZoomCommandProvider1.OwnerC1Zoom.ScrollLocation = currentLocation
End Sub

C#	コードのコピー
private void button1_Click(object sender, EventArgs e) { Point currentLocation = C1ZoomCommandProvider1.OwnerC1Zoom.ScrollLocation; currentLocation.X -= 100; currentLocation.Y -= 100; C1ZoomCommandProvider1.OwnerC1Zoom.ScrollLocation = currentLocation; }

コードのコピー

private void button1_Click(object sender, EventArgs e)
{
    Point currentLocation = C1ZoomCommandProvider1.OwnerC1Zoom.ScrollLocation;
    currentLocation.X -= 100;
    currentLocation.Y -= 100;
    C1ZoomCommandProvider1.OwnerC1Zoom.ScrollLocation = currentLocation;
}