uitoolbar

Figure にツール バーを作成

構文

tb = uitoolbar

tb = uitoolbar(parent)

tb = uitoolbar(___,Name,Value)

説明

tb = uitoolbar は現在の Figure 内にツール バーを作成し、Toolbar オブジェクトを返します。関数 figure を使用して作成された Figure が存在しない場合、MATLAB^® によりこれが作成され、親として機能します。

tb = uitoolbar(parent) は、指定された親 Figure にツール バーを作成します。

tb = uitoolbar(___,Name,Value) は、1 つ以上の名前と値の引数を使用して指定されたプロパティ値をもつツール バーを作成します。前述の構文のいずれかを使用して、名前と値の引数を指定します。

例

プッシュ ツールを備えたツール バーの作成

関数 uifigure を呼び出して UI figure を作成します。Figure にツール バーを追加します。

f = uifigure;
tb = uitoolbar(f);

ツール バー内にプッシュ ツールを作成し、ツール バーのアイコンをイメージ pepper.png として指定します。

pt = uipushtool(tb,Icon="peppers.png");

ツールの順序の変更

ツール バーにおける左から右へのツールの順序を変更します。この場合、UI figure ツール バーにあるプッシュ ツールおよびトグル ツールの順序を逆にします。

UI figure を作成します。そこにツール バーを追加します。次に、ツール バーにプッシュ ツールとトグル ツールを追加します。

fig = uifigure;
tb = uitoolbar(fig);
pt = uipushtool(tb);
tt = uitoggletool(tb);

プッシュ ツールの Icon プロパティをイメージ ファイル peppers.png に設定します。

pt.Icon = "peppers.png";

青色のトゥルーカラー イメージ配列を作成します。この配列にトグル ツールの 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;

入力引数

parent — 親 Figure

Figure オブジェクト

親 Figure。Figure オブジェクトとして指定します。親 Figure を指定しない場合は、MATLAB で関数 figure が呼び出されて親となる Figure が作成されます。

名前と値の引数

オプションの引数のペアを Name1=Value1,...,NameN=ValueN として指定します。ここで、Name は引数名で、Value は対応する値です。名前と値の引数は他の引数の後に指定しなければなりませんが、ペアの順序は重要ではありません。

R2021a より前では、コンマを使用してそれぞれの名前と値を区切り、Name を引用符で囲みます。

例: 'Visible','off' は、ツール バーの可視性を 'off' に設定します。

メモ

ここでは、プロパティの一部だけを紹介しています。完全な一覧については、Toolbar を参照してください。

Visible — 可視性の状態

'on' (既定値) | on/off の logical 値

可視性の状態。'on' または 'off' として指定するか、数値または logical の 1 (true) または 0 (false) として指定します。'on' の値は true と等価であり、'off' の値は false と等価です。したがって、このプロパティの値を logical 値として使用できます。値は matlab.lang.OnOffSwitchState 型の on/off logical 値として格納されます。

• 'on' — オブジェクトを表示します。

• 'off' — オブジェクトを削除せずに非表示にします。非表示の UI コンポーネントのプロパティには引き続きアクセスできます。

アプリの起動を高速化するには、起動時に表示する必要のないすべての UI コンポーネントの Visible プロパティを 'off' に設定します。

Children — Toolbar の子

空の GraphicsPlaceholder 配列 (既定値) | コンポーネント オブジェクトの 1 次元配列

Toolbar の子。空の GraphicsPlaceholder またはコンポーネント オブジェクトの 1 次元配列として返されます。Toolbar オブジェクトの子は、PushTool オブジェクトおよび ToggleTool オブジェクトです。

Children プロパティを使用して子の追加や削除を行うことはできません。このプロパティは、子のリストの参照や子の並べ替えに使用します。この配列の子の順序は、ツール バーに表示されるツールの右から左への順序を反映しています。つまり、右端のツールがリストの一番上にあり、左端のツールがリストの一番下にあります。たとえば、Children プロパティによって返されるこのツールの順序は、プッシュ ツールがツール バーのトグル ツールの左側に表示されることを示します。

toolOrder = tb.Children

toolOrder = 

  2×1 graphics array:

  ToggleTool
  PushTool

このリストに子を追加するには、子コンポーネントの Parent プロパティを uitoolbar オブジェクトに設定します。

HandleVisibility プロパティが 'off' に設定されているオブジェクトは Children プロパティにリストされません。

ヒント

• ツール バーには、プッシュ ツールまたはトグル ツールを含めることができます。プッシュ ツールは、プッシュ ボタンと同じように動作します。クリックすると、マウス ボタンが離れるまで押し下げられたままになります。トグル ツールには、'off' または 'on' の 2 つの状態があります。ボタンの状態はクリックするたびに変更されます。

• Toolbar オブジェクト (およびその子 PushTool オブジェクトおよび ToggleTool オブジェクト) は、WindowStyle プロパティが 'modal' に設定されている Figure には表示されません。ツール バーの子を含む Figure の WindowStyle が 'modal' に変更された場合、ツール バーの子は Figure の Children プロパティに依然として存在します。ただし、WindowStyle が 'modal' に設定されている間、このツール バーは表示されません。

バージョン履歴

R2006a より前に導入

R2025a: figure ベースのアプリでツール バーの背景色を指定

BackgroundColor プロパティを設定して、figure 関数を使用して作成されたアプリ内のツール バーの背景色を指定します。

R2022b: uifigure ベースのアプリでツール バーの背景色を指定

BackgroundColor プロパティを設定して、uifigure 関数を使用して作成されたアプリ内のツール バーの背景色を指定します。

参考

関数

• uipushtool | uitoggletool | figure | uifigure

プロパティ

• Toolbar