Toolbar
ツール バー UI コンポーネント
説明
ツール バー UI コンポーネントは、Figure ウィンドウの上部に水平方向のボタンのリストを表示します。Toolbar オブジェクトを使用して、ツール バーの作成後にツールバーの外観と動作を変更します。
作成
uitoolbar 関数を使用して、Figure でツール バーを作成します。
プロパティ
色
背景色。RGB 3 成分、16 進数カラー コード、または表にリストされた色オプションのいずれかとして指定します。
RGB 3 成分および 16 進数カラー コードは、カスタム色を指定するのに役立ちます。
RGB 3 成分は、色の赤、緑、青成分の強度を指定する 3 成分の行ベクトルです。強度値は
[0,1]の範囲でなければなりません。たとえば[0.4 0.6 0.7]のようになります。16 進数カラー コードは、ハッシュ記号 (
#) で始まり、3 桁または 6 桁の0からFまでの範囲の 16 進数が続く文字ベクトルまたは string スカラーです。この値は大文字と小文字を区別しません。したがって、カラー コード"#FF8800"、"#ff8800"、"#F80"、および"#f80"は等価です。
あるいは、名前を使用して一部の一般的な色を指定できます。次の表に、名前の付いた色オプション、等価の RGB 3 成分、および 16 進数カラー コードを示します。
| 色名 | 省略名 | RGB 3 成分 | 16 進数カラー コード | 外観 |
|---|---|---|---|---|
"red" | "r" | [1 0 0] | "#FF0000" |
|
"green" | "g" | [0 1 0] | "#00FF00" |
|
"blue" | "b" | [0 0 1] | "#0000FF" |
|
"cyan" | "c" | [0 1 1] | "#00FFFF" |
|
"magenta" | "m" | [1 0 1] | "#FF00FF" |
|
"yellow" | "y" | [1 1 0] | "#FFFF00" |
|
"black" | "k" | [0 0 0] | "#000000" |
|
"white" | "w" | [1 1 1] | "#FFFFFF" |
|
次の表に、ライト テーマとダーク テーマでのプロットの既定のカラー パレットを示します。
| パレット | パレットの色 |
|---|---|
R2025a より前: ほとんどのプロットで、これらの色が既定で使用されます。 |
|
|
|
orderedcolors 関数と rgb2hex 関数を使用すると、これらのパレットの RGB 3 成分および 16 進数カラー コードを取得できます。たとえば、"gem" パレットの RGB 3 成分を取得し、16 進数カラー コードに変換します。
RGB = orderedcolors("gem");
H = rgb2hex(RGB);R2023b より前: RGB = get(groot,"FactoryAxesColorOrder") を使用して、RGB 3 成分を取得します。
R2024a より前: H = compose("#%02X%02X%02X",round(RGB*255)) を使用して、16 進数カラー コードを取得します。
対話機能
このプロパティを設定してもこのタイプのオブジェクトには影響しません。
コールバック
コールバック実行制御
親/子
親オブジェクト。Figure オブジェクトとして指定します。親 Figure を指定しない場合は、MATLAB で関数 figure が呼び出されて親となる Figure が作成されます。
このプロパティをターゲット Figure オブジェクトに設定することで、Toolbar オブジェクトを別の Figure に移動できます。
Toolbar の子。空の GraphicsPlaceholder またはコンポーネント オブジェクトの 1 次元配列として返されます。Toolbar オブジェクトの子は、PushTool オブジェクトおよび ToggleTool オブジェクトです。
Children プロパティを使用して子の追加や削除を行うことはできません。このプロパティは、子のリストの参照や子の並べ替えに使用します。この配列の子の順序は、ツール バーに表示されるツールの右から左への順序を反映しています。つまり、右端のツールがリストの一番上にあり、左端のツールがリストの一番下にあります。たとえば、Children プロパティによって返されるこのツールの順序は、プッシュ ツールがツール バーのトグル ツールの左側に表示されることを示します。
toolOrder = tb.Children
toolOrder = 2×1 graphics array: ToggleTool PushTool
このリストに子を追加するには、子コンポーネントの Parent プロパティを Toolbar オブジェクトに設定します。
HandleVisibility プロパティが 'off' に設定されているオブジェクトは Children プロパティにリストされません。
オブジェクト ハンドルの可視性。'on'、'callback' または 'off' として指定します。
このプロパティは、オブジェクトの親がもつ子のリストにおけるそのオブジェクトの可視性を制御します。オブジェクトがその親オブジェクトのリストで、子として可視できない場合、オブジェクト階層の検索またはプロパティのクエリによってオブジェクトを取得する関数は、そのオブジェクトを返しません。このような関数には get、findobj、gca、gcf、gco、newplot、cla、clf および close があります。HandleVisibility プロパティはまた、親 Figure の CurrentObject プロパティでオブジェクトのハンドルの可視性も制御します。オブジェクトは参照できない場合も有効です。オブジェクトにアクセスできる場合は、そのプロパティを設定および取得して、それをオブジェクトに作用する任意の関数に渡すことができます。
| HandleVisibility の値 | 説明 |
|---|---|
'on' | オブジェクト ハンドルは常に表示されます。 |
'callback' | オブジェクト ハンドルはコールバック内から、あるいはコールバックにより呼び出される関数から参照できます。しかし、コマンド ラインから呼び出される関数からは参照できません。このオプションを使用すると、コマンド ラインからのオブジェクトへのアクセスがブロックされますが、コールバック関数からはアクセスできます。 |
'off' | オブジェクト ハンドルは常に非表示です。このオプションは、他の関数による UI の意図しない変更を防止するために役立ちます。HandleVisibility を 'off' に設定すると、その関数の実行中にハンドルが一時的に非表示になります。 |
識別子
この プロパティ は読み取り専用です。
グラフィックス オブジェクトのタイプ。'uitoolbar' として返されます。
例
ツール バーにおける左から右へのツールの順序を変更します。この場合、UI figure ツール バーにあるプッシュ ツールおよびトグル ツールの順序を逆にします。
UI figure を作成します。そこにツール バーを追加します。次に、ツール バーにプッシュ ツールとトグル ツールを追加します。
fig = uifigure; tb = uitoolbar(fig); pt = uipushtool(tb); tt = uitoggletool(tb);
ツール バー内にプッシュ ツールを作成します。Icon プロパティ値をイメージ ファイル matlabicon.gif に設定します。
pt.Icon = fullfile(matlabroot,'toolbox','matlab','icons','matlabicon.gif');
青色のトゥルーカラー イメージ配列を作成します。この配列に Icon プロパティの値を設定し、トグル ツールに青色の四角形のアイコンを表示させます。
ttImage = zeros(16,16,3); ttImage(:,:,3) = ones(16); tt.Icon = ttImage;
ツール バーの Children プロパティをクエリします。この配列で返される子の順序は、ツール バーに表示されるツールの右から左への順序を反映しています。トグル ツールは右端のツールで、リストの一番上 (配列の 1 番目の要素) に表示されます。
oldToolOrder = tb.Children
oldToolOrder = 2×1 graphics array: ToggleTool PushTool
関数 flipud を呼び出して、tb.Children で返される配列の要素の順序を反転させ、ツールの順序を逆にします。Children プロパティの値をこの新しいツール順序に設定します。プッシュ ツールはツール バーのトグル ツールの右側に表示されるようになりました。
newToolOrder = flipud(oldToolOrder); tb.Children = newToolOrder;
