zoom
ズーム モードの有効化
説明
ズーム モードを使用して、座標軸の範囲を対話的に変更してデータを探索できます。関数 zoom を使用して、ズーム モードの有効化または無効化と、その他の基本オプションの設定を行います。ズーム モードの動作をさらに制御するには、zoom オブジェクトを返して使用します。
線グラフ、棒グラフ、ヒストグラム、表面グラフを含むほとんどのチャートで、ズーム モードがサポートされています。ズーム モードをサポートするチャートでは、通常、座標軸ツール バーにズームイン アイコン 
とズームアウト アイコン 
が表示されます。
また、既定で有効になっている組み込みの座標軸操作を使用して、対話的にデータを探索することもできます。たとえば、スクロールやピンチ操作により、座標軸の表示をズームインまたはズームアウトできます。組み込み操作では、操作モードを有効にする必要がなく、操作モードよりも応答が高速です。一方、ズーム モードを有効にして、ズームの動作をカスタマイズすることができます。組み込み操作の詳細については、チャートの対話機能の制御を参照してください。
作成
説明
zoom は、現在の Figure 内のすべての座標軸について、ズーム モードを設定します。たとえば、optionzoom on はズーム モードを有効に、zoom xon はズーム モードを x 次元についてのみ有効に、zoom off はズーム モードを無効にします。
ズーム モードが有効の場合、カーソル、スクロール ホイール、またはキーボードを使用して座標軸の表示をズームします。
カーソル — ズームインするには、カーソルを座標軸の中心にする場所に置いて、クリックします。ズームアウトするには、Shift キーを押しながらクリックします。四角形の領域にズームインするには、クリックしてドラッグします。axes オブジェクトを基本のズーム レベルに戻すには、座標軸内でダブルクリックします。
スクロール ホイール — ズームインするには、上にスクロールします。ズームアウトするには、下にスクロールします。
キーボード — ズームインするには、上矢印 (↑) キーを押します。ズームアウトするには、下矢印 (↓) キーを押します。
一部の組み込み操作は、現在の操作モードに関係なく既定で有効になったままです。ズーム モードに依存しない組み込みのズーム操作を無効にするには、関数 disableDefaultInteractivity を使用します。
zoom はズーム モードを切り替えます。ズーム モードが無効になっている場合、zoom を呼び出すと、on、xon、または yon の、最近使用したズーム オプションが復元されます。
zoom( は、現在の座標軸を、指定された倍率でズームします (ズーム モードには影響なし)。たとえば、factor)zoom(3) のように、factor を 1 より大きい値として指定するとズームインします。たとえば、zoom(0.5) のように、factor を 0 と 1 の間の値として指定するとズームアウトします。
zoom( は、指定された Figure 内のすべての座標軸について、前述の任意の構文でズーム モードを設定します。ズーム モード オプションまたはズーム倍率として追加の引数を指定します。たとえば、Figure fig,___)fig 内のすべての座標軸についてズーム モードを有効にするには、zoom(fig,'on') を使用します。すべての座標軸を 2 倍ズームするには、zoom(fig,2) を使用します。
zoom( は、指定された座標軸についてズーム モードを設定します。ズーム モード オプションまたはズーム倍率として追加の引数を指定します。たとえば、座標軸 ax,___)ax についてズーム モードを有効にするには、zoom(ax,'on') を使用します。 (R2023a 以降)
R2025a より前: この構文は、App Designer で作成されたアプリ、または uifigure 関数を使用して作成されたアプリで使用します。
入力引数
ズーム モードのオプション。次の値のいずれかとして指定します。
'on'— ズーム モードを有効にします。'off'— ズーム モードを無効にします。一部の組み込み操作は、現在の操作モードに関係なく既定で有効になったままです。ズーム モードに依存しない組み込みのズーム操作を無効にするには、関数disableDefaultInteractivityを使用します。'reset'— 現在のズーム レベルを基本のズーム レベルとして設定します。基本のズーム レベルを設定すると、zoom outの呼び出し、座標軸内でのダブルクリック、または座標軸ツール バーの [表示の復元]
アイコンのクリックにより、座標軸がこのズーム レベルに戻ります。'out'— 現在の座標軸を基本のズーム レベルに戻します。'xon'— x 次元についてのみズーム モードを有効にします。'yon'— y 次元についてのみズーム モードを有効にします。'toggle'— はズーム モードを切り替えます。ズーム モードが無効になっている場合、'toggle'は、'on'、'xon'、または'yon'の、最近使用したズーム オプションを復元します。このオプションを使用することは、引数を指定せずにzoomを呼び出すことと同じです。
ズーム倍率。正の数値として指定します。factor を 1 より大きい数値として指定するとズームインします。factor を 0 と 1 の間の数値として指定するとズームアウトします。この場合、座標軸は 1/factor の倍率でズームアウトします。
ターゲット Figure。Figure オブジェクトとして指定します。ターゲット Figure を指定すると、現在または将来のすべての Axes の子にモードが設定されます。
ターゲット座標軸。Axes オブジェクトとして指定します。
プロパティ
オブジェクト関数
メモ
zoom オブジェクトに対してこれらのオブジェクト関数のいずれかを呼び出すと、MATLAB は Figure で従来の探索モードを有効にします。詳細については、enableLegacyExplorationModes を参照してください。
zoom オブジェクト関数を使用して、Figure 内の axes オブジェクトのズーム動作をカスタマイズします。これらすべての関数について、axes オブジェクトおよび zoom オブジェクトは同じ Figure に関連付けられていなければなりません。
| 関数 zoom オブジェクト
メモ 座標軸の |
| 関数 zoom オブジェクト
メモ 座標軸の |
| 関数 zoom オブジェクト
メモ 座標軸の |
| 関数 zoom オブジェクト
メモ 座標軸の |
| 関数 zoom オブジェクト カメラの画角の詳細については、カメラ グラフィックス用語を参照してください。 |
| 関数 zoom オブジェクト |
| この関数は推奨されません。代わりに zoom オブジェクト
|
| この関数は推奨されません。代わりに zoom オブジェクト
|
例
表面をプロットし、ズーム モードを有効にします。
surf(peaks)
zoom on
最も高いピークをクリックしてそこにズームインします。ここで基本のズーム レベルを設定します。以降の zoom out の呼び出しでは、座標軸をダブルクリックするか、座標軸ツール バーの [表示の復元] アイコンをクリックすると、座標軸が基本のズーム レベルに戻ります。
zoom reset
最も高いピークをクリックして、再度これにズームインします。その後、ズームアウトして、設定した基本のズーム レベルに戻ります。
zoom out
タイル表示チャート レイアウト内で 4 つの座標軸を作成し、それぞれに異なるズーム動作を割り当てます。その後、座標軸を対話的にズームします。
tiledlayout(2,2) ax1 = nexttile; plot(1:10); z = zoom; ax2 = nexttile; plot(rand(3)); setAllowAxesZoom(z,ax2,false); ax3 = nexttile; surf(peaks); setAxesZoomConstraint(z,ax3,'xy'); ax4 = nexttile; contour(peaks); setAxesZoomMotion(z,ax4,'horizontal');
表面をプロットし、関数 uicontextmenu を使用してコンテキスト メニューを作成します。
surf(peaks) cm = uicontextmenu;
そのメニューに項目を追加します。ラベルと Figure を閉じるコールバックを指定します。
m = uimenu(cm);
m.Label = 'Close figure';
f = gcf;
m.Callback = @(src,event)close(f);
zoom オブジェクトを作成します。zoom オブジェクトの ContextMenu プロパティを設定してコンテキスト メニューを追加します。その後、ズーム モードを有効にします。
z = zoom(f);
z.ContextMenu = cm;
z.Enable = 'on';
右クリックし、[Figure を閉じる] を選択して Figure を閉じます。
詳細
代替機能
座標軸ツール バー
一部のチャートでは、座標軸ツール バーのズームイン アイコン またはズームアウト アイコン をクリックして、ズーム モードを有効にします。
