scroll
Scroll to location within container, tree, list box, or text area
Description
scroll(
scrolls to the specified (x, y)
coordinates within a container. The coordinates are measured in pixels from
the lower-left corner of the container. This syntax supports figures created
with the component,x,y)uifigure function and any
of these child containers: grid layout, panel, button group, or tab. For
more information on when scrolling is possible, see Conditions that Enable Scrolling.
Examples
Scroll Within a Figure
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);
Scroll to Location in Grid
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');
Scroll to Component
Bring a component into view by specifying the scroll location as the first two position coordinates of the component you want to view.
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.Position(1:2));
Scroll to List Box 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;
Scroll to Tree Node
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;
