Main Content

uitabgroup

タブ付きパネルのコンテナーの作成

説明

tg = uitabgroup は、現在の Figure 内にタブ グループを作成し、TabGroup オブジェクトを返します。利用可能な Figure がない場合は、MATLAB® が関数 figure を呼び出して Figure を作成します。タブ グループはタブのコンテナーです。これらによって、選択されているタブを識別し、ユーザーが他のタブを選択するのを検出できるようになります。

tg = uitabgroup(Name,Value) は 1 つ以上の名前と値のペアの引数を使用して、タブ グループのプロパティ値を指定します。

tg = uitabgroup(parent) は、指定された親コンテナー内にタブ グループを作成します。親コンテナーには、関数 figure または関数 uifigure で作成された Figure か、パネルなどの子コンテナーを指定できます。uitabgroup のプロパティの値は、関数 figure で作成されたアプリと関数 uifigure で作成されたアプリで多少異なります。詳細については、名前と値のペアの引数を参照してください。

tg = uitabgroup(parent,Name,Value) は、親コンテナーと 1 つ以上のプロパティ値を指定します。

すべて折りたたむ

1 つのタブ グループと 2 つのタブを含む Figure を作成します。

f = figure;
tabgp = uitabgroup(f,'Position',[.05 .05 .3 .8]);
tab1 = uitab(tabgp,'Title','settings');
tab2 = uitab(tabgp,'Title','Options');

現在選択されているタブを取得します。

currenttab = tabgp.SelectedTab
currenttab = 

  Tab (settings) with properties:

              Title: 'settings'
    BackgroundColor: [0.9400 0.9400 0.9400]
           Position: [0.0119 0.0089 0.9702 0.9107]
              Units: 'normalized'

Scrollable プロパティによって、境界線外にコンポーネントがあるタブの内部でのスクロールが有効になります。スクロールを使用するには、この Figure が関数 uifigure で作成されていなければなりません。App Designer では、このタイプの Figure がアプリの作成に使用されます。

1 つのタブを含むタブ グループを作成します。6 つの UI コンポーネントをタブに追加し、最初の 3 つがタブの上縁から外れるようにします。

fig = uifigure;
tg = uitabgroup(fig,'Position',[20 20 196 145]);
t = uitab(tg,'Title','Member Informaion');
ef1 = uieditfield(t,'text','Position',[11 165 140 22],'Value','First Name');
ef2 = uieditfield(t,'text','Position',[11 140 140 22],'Value','Last Name');
ef3 = uieditfield(t,'text','Position',[11 115 140 22],'Value','Addess');
dd = uidropdown(t,'Position',[11 90 140 22],'Items',{'Male','Female'});
cb = uicheckbox(t,'Position',[11 65 140 22],'Text','Member');
b = uibutton(t,'Position',[11 40 140 22],'Text','Send');

タブの Scrollable プロパティを 'on' に設定して、スクロールを有効にします。既定では、スクロール バーは最上部に表示されます。

t.Scrollable = 'on';

入力引数

すべて折りたたむ

親コンテナー。関数 figure または関数 uifigure で作成された Figure か、子コンテナーとして指定します。

  • パネル、タブ、およびボタン グループは、いずれのタイプの Figure でもコンテナーとすることができる。

  • グリッド レイアウトは、関数 uifigure で作成された Figure 内でのみコンテナーとすることができる。

名前と値の引数

例: uitabgroup('TabLocation','bottom') は、タブ ラベルの位置をタブ グループの最下部に指定します。

オプションの Name,Value の引数ペアをコンマ区切りで指定します。Name は引数名で、Value は対応する値です。Name は一重引用符 (' ') で囲まなければなりません。Name1,Value1,...,NameN,ValueN のように、複数の名前と値のペアの引数を指定できます。

メモ

以下にリストするプロパティは、利用できるプロパティの一部です。完全なリストについては、TabGroup のプロパティ を参照してください。

現在選択されているタブ。Tab オブジェクトとして指定します。このプロパティを使用して、タブ グループ内で現在選択されているタブを特定します。このプロパティを使用すると、タブの既定の選択を設定することもできます。SelectedTab プロパティの既定値は、TabGroup に最初に追加された Tab です。

選択変更コールバック。次の値のいずれかとして指定します。

  • 関数ハンドル。

  • 最初の要素が関数ハンドルである cell 配列。cell 配列内のその後の要素はコールバック関数に渡される引数です。

  • 有効な MATLAB 式を含む文字ベクトル (非推奨)。MATLAB は、この式をベース ワークスペースで評価します。

このコールバック関数は、ユーザーがタブ グループ内で別のタブを選択したときに実行されます。

このコールバック関数は、ユーザーのタブ操作に関する特定の情報にアクセスできます。MATLAB は、この情報を SelectionChangedData オブジェクトに格納して、2 番目の引数としてコールバック関数に渡します。App Designer では、引数は event と呼ばれます。ドット表記を使用して、オブジェクトのプロパティをクエリできます。たとえば、event.NewValue は現在選択されているタブを返します。SelectionChangedData オブジェクトは、文字ベクトルとして指定されているコールバック関数では使用できません。

次の表に、SelectionChangedData オブジェクトのプロパティを示します。

プロパティ

説明

OldValue

前に選択されていた Tab、または何も選択されていなかった場合は []

NewValue

現在選択されている Tab

Source

コールバックを実行するコンポーネント

EventName

'SelectionChanged'

コールバックの記述の詳細については、App Designer でコールバックを記述するを参照してください。

タブ ラベルの位置。'top''bottom''left' または 'right' として指定します。このプロパティは、タブ グループに対するタブ ラベルの位置を指定します。

タブ グループの位置とサイズ。[left bottom width height] の形式の 4 要素ベクトルとして指定します。

次の表で、ベクトルの各要素について説明します。

要素説明
left親コンテナーの内側左端からタブ グループの外側左端までの距離
bottom親コンテナーの内側下端からタブ グループの外側下端までの距離
widthタブ グループの外側の右端と左端の間の距離
heightタブ グループの外側の上端と下端の間の距離

すべての測定値は、Units プロパティで指定した単位で表されます。

Position の値の基準は、親コンテナーの "描画可能領域" です。描画可能領域は、コンテナーの境界線の内側にある領域で、メニュー バーやタイトルなどの装飾が占める領域は含まれません。

測定の単位。次の表のいずれかの値として指定します。

単位の値説明
'pixels' (既定)

Windows® および Macintosh システムでのピクセル単位の距離は、システムの解像度に依存しません。

  • Windows システムの 1 ピクセルは 1/96 インチです。

  • Macintosh システムの 1 ピクセルは 1/72 インチです。

Linux® システムでは、ピクセルのサイズは使用しているシステムの解像度によって決まります。

'normalized'

これらの単位は親コンテナーを基準として正規化されます。コンテナーの左下隅が (0,0) で、右上隅が (1,1) になります。

'inches'インチ。
'centimeters'センチメートル。
'points'ポイント。1 ポイントは 1/72 インチです。

MATLAB のほとんどのアプリ作成機能では距離をピクセル単位で測定するため、推奨値は 'pixels' です。親コンテナーのサイズに基づいて再スケーリングされるパネルを作成するには、関数 uigridlayout を使用して作成されたグリッド レイアウト マネージャーをパネルの親にします。詳細については、Lay Out Apps Programmaticallyを参照してください。

figure ベースのアプリ

関数 figure を使用して作成されたアプリ内のタブ グループの場合、Units の既定値は 'normalized' です。

また、Units として 'characters' を指定できます。文字単位は、グラフィックス ルート オブジェクトの既定の uicontrol フォントを基にしています。

  • 文字の幅 = 文字 x の幅。

  • 文字の高さ = 2 行のテキストのベースライン間の距離。

既定の uicontrol フォントにアクセスするには、get(groot,'defaultuicontrolFontName') または set(groot,'defaultuicontrolFontName') を使用します。

バージョン履歴

R2014b で導入

参考

関数

プロパティ