このページの翻訳は最新ではありません。ここをクリックして、英語の最新版を参照してください。

scroll

コンテナー、ツリー、リスト ボックス、テキスト エリア内の場所へのスクロール

構文

scroll(component,location)

scroll(component,x,y)

scroll(component,coord)

説明

scroll(component,location) は、コンポーネント内の指定された位置までスクロールします。この構文は、関数 uifigure を使用して作成された Figure 内、または子コンポーネントであるグリッド レイアウト、パネル、ボタン グループ、タブ、ツリー、リスト ボックス、またはテキスト エリア内でのスクロールに使用します。

scroll(component,x,y) は、コンテナー内の指定された (x, y) 座標までスクロールします。座標はコンテナーの左下隅からピクセル単位で測定されています。この構文は、関数 uifigure を使用して作成された Figure と、子コンテナーであるグリッド レイアウト、パネル、ボタン グループ、またはタブをサポートします。スクロールが可能な場合の詳細については、スクロールを有効にするための条件を参照してください。

scroll(component,coord) はピクセル座標を 2 要素のベクトル coord として指定します。たとえば、scroll(fig,[100 150]) は Figure を座標 (100,150) にスクロールします。

例

Figure 内でのスクロール

Figure を作成し、Scrollable プロパティを 'on' に設定します。次に、子コンポーネントを 5 個追加します。Figure を確実にスクロール可能にするには、最初のコンポーネントを Figure の上端より上に配置します。その後、コンポーネントが Figure 内に一緒に収まらないようにするために、それぞれを十分に離して配置します。

% Create figure
fig = uifigure('Name','Customer','Scrollable','on');
fig.Position = [100 100 493 283];

% Title label
title = uilabel(fig,'Text','Customer Record');
title.FontSize = 18;
title.FontWeight = 'bold';
title.Position = [173 315 157 22];

% Name
name = uieditfield(fig,'text');
name.Position = [169 239 173 22];
namelabel = uilabel(fig,'Text','Name','HorizontalAlignment','right');
namelabel.Position = [116 239 38 22];

% Phone
phone = uieditfield(fig,'text');
phone.Position = [169 164 173 22];
phonelabel = uilabel(fig,'Text','Phone','HorizontalAlignment','right');
phonelabel.Position = [114 164 40 22];

% Balance
balance = uieditfield(fig,'numeric');
balance.Position = [169 89 173 22];
balancelabel = uilabel(fig,'Text','Balance','HorizontalAlignment','right');
balancelabel.Position = [105 89 49 22];

% Submit button
button = uibutton(fig,'push','Text','Submit');
button.Position = [169 14 173 22];

既定では、MATLAB^® は子コンポーネントを囲む領域の左上隅にスクロールします。

Figure の最下部である、位置 (1,1) にスクロールします。

scroll(fig,1,1);

グリッド内の位置にスクロール

ピクセル座標または位置名を指定して、スクロール可能なグリッド レイアウトの子コンポーネントを表示します。

5 行 2 列のグリッド レイアウトを作成し、グリッドの Scrollable プロパティを 'on' に設定します。その後、ラベル、テーブル、パネルをグリッドに追加します。パネルの Scrollable プロパティを 'off' に設定し、チャートをパネルに追加します。

fig = uifigure('Position',[782 497 435 311]);
g = uigridlayout(fig,'Scrollable','on');
g.RowHeight = {22,40,22,22,400};
g.ColumnWidth = {400,400};

lbl = uilabel(g,'Text','Tsunamis');
lbl.Layout.Row = 2;
lbl.Layout.Column = [1,2];
lbl.HorizontalAlignment = 'center';
lbl.FontSize = 28;

tsunamis = readtable('tsunamis.xlsx');
tsunamis.Cause = categorical(tsunamis.Cause);
t = uitable(g,'Data',tsunamis);
t.Layout.Row = [3,5];
t.Layout.Column = 2;

p = uipanel(g);
p.Scrollable = 'off';
p.Layout.Row = [3,5];
p.Layout.Column = 1;
gb = geobubble(p,tsunamis.Latitude,tsunamis.Longitude,...
    tsunamis.MaxHeight,tsunamis.Cause);

グリッド内の位置にスクロールします。

scroll(g,100,-30);

次に、位置名を使用して、グリッドの右下の隅にスクロールします。

scroll(g,'bottom','right');

コンポーネントにスクロール

スクロール位置を、表示するコンポーネントの最初の 2 つの位置座標として指定し、コンポーネントを表示します。

ドロップダウン コンポーネントが 2 つ、リスト ボックスが 1 つ、テーブルが 1 つある Figure を作成します。これらのコンポーネントを、Figure 内ですべて同時に表示されないように配置します。

fig = uifigure;
fig.Scrollable = 'on';
fig.Position = [100 300 328 110];

dd1 = uidropdown(fig);
dd1.Position = [20 360 120 22];

dd2 = uidropdown(fig);
dd2.Position = [20 200 120 22];

lb = uilistbox(fig);
lb.Position = [230 300 120 80];

t = readtable('patients.xls');
uit = uitable(fig,'Data',t);
uit.Position = [375 100 300 300];

テーブルにスクロールします。

scroll(fig,uit.Position(1:2));

リスト ボックスの項目にスクロール

名前および関連付けられた ItemsData のリストを含むリスト ボックスを作成します。

fig = uifigure('Position',[680 678 300 200]);
list = uilistbox(fig, 'Position',[70 50, 150 78]);
list.Items = {'Diane Fitzsimmons', 'Naomi Becker', 'Nick Stewart',...
           'Alex Bradford', 'Caroline Eliot', 'Leslie Bond', ...
           'Aaron Silberlicht', 'Ramu Sadasiv', 'Joyce Wu',...
           'Ann Shanahan'};
list.ItemsData = [1 2 3 4 5 6 7 8 9 10];

[Caroline Eliot] にスクロールします。

scroll(list,'Caroline Eliot');

[Caroline Eliot] を選択するには、Value プロパティを ItemsData プロパティの対応する要素に設定します。

list.Value = 5;

ツリー ノードにスクロール

4 つの最上位ノードとそれぞれの子ノードを含むツリーを作成します。

fig = uifigure;
tree = uitree(fig,'Position',[20 20 175 100]);
    
% First level nodes
category1 = uitreenode(tree,'Text','Runners');
category2 = uitreenode(tree,'Text','Cyclists');
category3 = uitreenode(tree,'Text','Hikers');
category4 = uitreenode(tree,'Text','Swimmers');

% Second level nodes
r1 = uitreenode(category1,'Text','Joe');
r2 = uitreenode(category1,'Text','Linda');
c1 = uitreenode(category2,'Text','Rajeev');
h1 = uitreenode(category3,'Text','Jack');
s1 = uitreenode(category4,'Text','Logan');

ノードを展開します。[Swimmers] がビューの外側にスクロールします。

expand(tree);

[Swimmers] ノードにスクロールします。

scroll(tree,category4)

Tree オブジェクトの SelectedNodes プロパティを設定して、[Swimmers] ノードを選択します。

tree.SelectedNodes = category4;

入力引数

component — スクロール可能なコンポーネント

Figure オブジェクト | GridLayout オブジェクト | Panel オブジェクト | ButtonGroup オブジェクト | Tab オブジェクト | ListBox オブジェクト | ...

スクロール可能なコンポーネント。関数 uifigure を使用して作成された Figure、またはその Figure 内にあるグリッド レイアウト、パネル、ボタン グループ、タブ、ツリー、リスト ボックス、またはテキスト エリアのいずれかのコンポーネントとして指定します。

location — スクロール位置

'top' | 'bottom' | ...

スクロール位置。'top' または 'bottom'、あるいは table にリストされた値として指定します。値 'top' と値 'bottom' は、コンポーネントの最上部と最下部にスクロールします。他の値はコンポーネントのタイプに固有です。コンテナーの隅までスクロールするには、'top' または 'bottom' スクロール位置と 'left' または 'right' を組み合わせます。たとえば、scroll(fig,'left','top') のようになります。

コンポーネント	値
Figure パネル ボタン グループ タブ グリッド レイアウト	'left' — コンテナーの左端までスクロール。 'right' — コンテナーの右端までスクロール。
ツリー	TreeNode オブジェクト — 指定されたツリー ノードまでスクロール。
リスト ボックス	Items プロパティの要素 — リスト ボックス内の指定された項目までスクロール。 ItemsData プロパティの要素 — リスト ボックス内の対応する項目までスクロール。

x — x 座標

整数

x 座標。コンテナーの左端を基準としたピクセル単位の整数として指定します。指定した値がコンテナーのスクロール可能な領域を超える場合、コンテナーは指定した方向に向かって可能な限りスクロールします。

y — y 座標

整数

y 座標。コンテナーの下端を基準としたピクセル単位の整数として指定します。指定した値がコンテナーのスクロール可能な領域を超える場合、コンテナーは指定した方向に向かって可能な限りスクロールします。

グリッド レイアウトの高さが親コンテナーより高い場合、負の y 座標を使用すると、親コンテナーの下端より下にあるグリッド内のコンポーネントにスクロールできます。

coord — ピクセル座標

整数の行ベクトル

ピクセル座標。整数値の 2 要素の行ベクトルとして指定します。

例: [100 150] はピクセル座標 (100,150) を指定します。

詳細

スクロールを有効にするための条件

コンテナー内でスクロールできるようにするには、コンテナーの 'Scrollable' プロパティが 'on' に設定されていなければなりません。これに加えて、以下のコンテナー特有の条件を満たしていなければなりません。

グリッド レイアウト

• グリッドの 'RowHeight' プロパティに対して指定した値の合計は、親コンテナーの高さより大きくなければならない。

• グリッドの 'ColumnWidth' プロパティに対して指定した値の合計は、親コンテナーの幅より大きくなければならない。

• グリッドの少なくとも 1 行または 1 列が、固定ピクセルの高さまたは幅に設定されていなければならない。

• グリッドにコンポーネントが含まれていなければならない。

グリッド レイアウト以外のコンテナー

• コンテナー内の子コンポーネントは、コンテナーが一度に表示できるよりも大きい領域を占めていなければならない。

• コンテナーに収まらないコンポーネントは、コンテナーより上または右になければならない。

参考

関数

• uifigure | uigridlayout | uilistbox | uitextarea | uitree | uitreenode

プロパティ

• GridLayout のプロパティ | ListBox のプロパティ | TextArea のプロパティ | Tree のプロパティ | TreeNode のプロパティ | UI Figure のプロパティ

トピック

• App Designer でのグラフィックスの表示

R2016a で導入