axtoolbarbtn
座標軸ツール バーにボタンを追加
説明
は、btn
= axtoolbarbtn(tb
)tb
で指定された座標軸ツール バーにプッシュ ボタンを追加し、ToolbarPushButton
オブジェクトを返します。
は、1 つ以上の名前と値のペアの引数を使用して、ボタンのプロパティを指定します。btn
= axtoolbarbtn(tb
,style
,Name,Value
)
例
座標軸のグリッド ラインの表示と非表示を切り替えるカスタムの状態ボタンを座標軸ツール バーに追加します。
まず、mycustomstatebutton.m
というプログラム ファイルを作成します。プログラム ファイル内で次を行います。
乱数データをプロットします。
関数
axtoolbar
を使用して、ズームイン、ズームアウト、表示の復元の各オプションをもつ座標軸ツール バーを作成します。関数
axtoolbarbtn
を使用して、ツール バーに空の状態ボタンを追加します。ToolbarStateButton
オブジェクトを返します。Icon
、Tooltip
、ValueChangedFcn
の各プロパティを設定して、状態ボタンのアイコン、ツール ヒントおよびコールバック関数を指定します。この例ではアイコンを使用します。まず、これを
mygridicon.png
というイメージ ファイルとしてパス上に保存しなければなりません。
プログラム ファイルの実行後、アイコンをクリックしてグリッドラインの表示と非表示を切り替えます。
function mycustomstatebutton plot(rand(5)) ax = gca; tb = axtoolbar(ax,{'zoomin','zoomout','restoreview'}); btn = axtoolbarbtn(tb,'state'); btn.Icon = 'mygridicon.png'; btn.Tooltip = 'Grid Lines'; btn.ValueChangedFcn = @customcallback; function customcallback(src,event) switch src.Value case 'off' event.Axes.XGrid = 'off'; event.Axes.YGrid = 'off'; event.Axes.ZGrid = 'off'; case 'on' event.Axes.XGrid = 'on'; event.Axes.YGrid = 'on'; event.Axes.ZGrid = 'on'; end end end
座標軸の表示を 2 次元表示にスナップする、カスタムのプッシュ ボタンを座標軸ツール バーに作成します。
まず、mycustompushbutton.m
というプログラム ファイルを作成します。プログラム ファイル内で次を行います。
表面をプロットします。
関数
axtoolbar
を使用して、ズームイン、ズームアウト、回転、表示を元に戻すの各オプションをもつ座標軸ツール バーを作成します。関数
axtoolbarbtn
を使用して、ツール バーに空のプッシュ ボタンを追加します。ToolbarPushButton
オブジェクトを返します。Icon
、Tooltip
、ButtonPushedFcn
の各プロパティをそれぞれ設定して、プッシュ ボタンのアイコン、ツール ヒントおよびコールバック関数を指定します。この例ではアイコンを使用します。まず、これを
my2dicon.png
というイメージ ファイルとしてパス上に保存しなければなりません。
プログラム ファイルを実行すると、アイコンをクリックして座標軸の表示を 2 次元表示にスナップします。
function mycustompushbutton surf(peaks(25)) ax = gca; tb = axtoolbar(ax,{'zoomin','zoomout','rotate','restoreview'}); btn = axtoolbarbtn(tb,'push'); btn.Icon = 'my2dicon.png'; btn.Tooltip = 'Snap to 2-D view'; btn.ButtonPushedFcn = @customcallback; function customcallback(src,event) view(event.Axes,2) end end
入力引数
ツール バー。AxesToolbar
オブジェクトとして指定します。ツール バーを作成するには、tb = axestoolbar
のように関数 axtoolbar
を使用します。
ボタンのスタイル。次のオプションのいずれかとして指定します。
スタイル | 説明 |
---|---|
'push' | プッシュ ボタン。1 回クリックすると、ボタンは押して離したように表示されます。 |
'state' | 2 つの状態をとる状態ボタン。1 回クリックすると、再度クリックするまでボタンは押された状態または離された状態のままです。 |
名前と値の引数
オプションの引数のペアを Name1=Value1,...,NameN=ValueN
として指定します。ここで、Name
は引数名で、Value
は対応する値です。名前と値の引数は他の引数の後に指定しなければなりませんが、ペアの順序は重要ではありません。
R2021a より前では、コンマを使用して名前と値をそれぞれ区切り、Name
を引用符で囲みます。
例: axtoolbarbtn(tb,'push','Icon','myimage.png','Tooltip','My Icon Tooltip')
メモ
ここには一部のプロパティのみを示します。プッシュ ボタンと状態ボタンは、異なるプロパティのセットをサポートします。プロパティの完全なリストと各タイプについての説明は、対応するプロパティのページを参照してください。
ボタン アイコン。次の値のいずれかとして指定します。座標軸ツール バーには、アイコンがグレースケール イメージとして表示されます。イメージが収まるように、MATLAB® は必要に応じてイメージを縮小します。
ファイル名 — ファイル名を文字ベクトルまたは string スカラーとして指定します。ファイル名の前にパスを指定できます。イメージ ファイルは、JPEG、GIF、PNG のいずれかの形式でなければなりません。
配列 — イメージ内のピクセルを表す、RGB 3 成分からなる m×n×3 の配列を指定します。
行列 — イメージ内のピクセルを表す、m 行 n 列の数値行列を指定します。
値が整数型である場合は、
0
~63
の値を指定します。値0
は不透明で、値63
は透明です。NaN
も透明です。値が
double
型の場合は、1
~64
の値を指定します。値1
は不透明で、値64
は透明です。NaN
も透明です。
事前定義されたアイコン — 次の表にある名前のいずれかを指定します。
アイコン名 結果 'brush'
'datacursor'
'export'
'rotate'
'pan'
'zoomin'
'zoomout'
'restoreview'
'none'
アイコンなし
例: btn.Icon = 'icon.png'
例: btn.Icon = 'C:\Documents\icon.png'
例: btn.Icon = 'rotate'
ボタンのツール ヒント。文字ベクトル、文字ベクトルの cell 配列、または string 配列として指定します。このプロパティを使用すると、ポインターをボタンに合わせたときにメッセージが表示されます。複数行のテキストを表示するには、文字ベクトルの cell 配列または string 配列を指定します。配列の各要素は、テキストの各行を表示します。
例: btn.Tooltip = 'My Tooltip'
バージョン履歴
R2018b で導入
MATLAB Command
You clicked a link that corresponds to this MATLAB command:
Run the command by entering it in the MATLAB Command Window. Web browsers do not support MATLAB commands.
Web サイトの選択
Web サイトを選択すると、翻訳されたコンテンツにアクセスし、地域のイベントやサービスを確認できます。現在の位置情報に基づき、次のサイトの選択を推奨します:
また、以下のリストから Web サイトを選択することもできます。
最適なサイトパフォーマンスの取得方法
中国のサイト (中国語または英語) を選択することで、最適なサイトパフォーマンスが得られます。その他の国の MathWorks のサイトは、お客様の地域からのアクセスが最適化されていません。
南北アメリカ
- América Latina (Español)
- Canada (English)
- United States (English)
ヨーロッパ
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)