scroll
Scroll to location within UI component
Syntax
Description
Scrollable Container or Button Group
scroll(
scrolls a container or button group vertically. Specify
container,vlocation)vlocation as 'top' or
'bottom'. For more information on when
scrolling is possible, see Conditions that Enable Scrolling.
Text Area
Tree
List Box
Table
scroll(
scrolls to the specified row, column, or cell of a table. For example,
tbl,tableTarget,tableIndex)scroll(uit,'Row',10) scrolls to the tenth row
of the table.
Examples
Scroll to specified
(x,y)-coordinates within a figure created using the
uifigure
function.
Create a figure, and set the Scrollable
property to 'on'. Then add five child
components. To ensure that the figure is scrollable, place the
first component above the top edge of the figure. Then space the
components far enough apart so that they cannot fit within the
figure together.
% 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];
By default, MATLAB® scrolls to the upper-left corner of the area that encloses the child components.
Scroll to location (1,1), which is the bottom
of the figure.
scroll(fig,1,1)
Bring child components of a scrollable grid layout into view by specifying pixel coordinates or a location name.
Create a 5-by-2 grid layout and set the Scrollable property
of the grid to 'on'. Then add a label, a table, and a panel to
the grid. Set the Scrollable property of the panel to
'off' and then add a chart to the panel.
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 to a location in the grid.
scroll(g,100,-30)
Now use location names to scroll to the bottom-right corner of the grid.
scroll(g,'bottom','right')
Bring a component into view by specifying it as the scroll location.
Create a figure with two drop-down components, a list box, and a table. Position the components so that they cannot all be displayed within the figure at one time.
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 to the table.
scroll(fig,uit)
Scroll to the bottom of a text area programmatically.
Create a text area. Specify a size and long text for it.
fig = uifigure;
txa = uitextarea(fig);
txa.Position = [100 100 80 80];
txa.Value = "Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor.";
Scroll to the bottom of the text area.
scroll(txa,"bottom")
Bring an item of a list box into view by specifying the item.
Create a list box containing a list of names with associated
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];
Scroll to Caroline Eliot.
scroll(list,'Caroline Eliot')
Select Caroline Eliot by setting the
Value property to the corresponding
element in the ItemsData property.
list.Value = 5;
Bring a tree node into view by specifying the
TreeNode object.
Create a tree containing four top-level nodes that each have child nodes.
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');
Expand the nodes, so that Swimmers
scrolls out of view.
expand(tree)
Scroll to the Swimmers node.
scroll(tree,category4)
Select the Swimmers node by setting
the SelectedNodes property of the
Tree object.
tree.SelectedNodes = category4;
Read sample patient data into the workspace as a table array. Then, create a table UI component to display the data.
tdata = readtable("patients.xls"); vars = ["Age","Systolic","Diastolic","Smoker"]; tdata = tdata(1:40,vars); fig = uifigure; uit = uitable(fig,"Data",tdata); uit.RowName = "numbered";
Scroll to the 25th row of the table.
scroll(uit,"row",25)
Input Arguments
More About
Version History
Introduced in R2016aSee Also
Functions
uifigure|uigridlayout|uitextarea|uitree|uitreenode|uilistbox|uitable|isInScrollView
