uislider

슬라이더 또는 범위 슬라이더 컴포넌트 만들기

구문

sld = uislider

sld = uislider(style)

sld = uislider(parent)

sld = uislider(parent,style)

sld = uislider(___,Name,Value)

설명

sld = uislider는 새 Figure 창에 표준 슬라이더를 만들고 Slider 객체를 반환합니다. MATLAB^®은 uifigure 함수를 호출하여 Figure를 만듭니다.

sld = uislider(style)은 지정된 스타일의 슬라이더를 만듭니다. 표준 슬라이더 대신 범위 슬라이더를 만들려면 style을 "range"로 지정하십시오.

sld = uislider(parent)는 지정된 부모 컨테이너에서 슬라이더를 만듭니다. 부모 컨테이너는 Figure 객체이거나 그 자식 컨테이너 중 하나일 수 있습니다.

sld = uislider(parent,style)은 지정된 부모 컨테이너에 지정된 스타일의 슬라이더를 만듭니다.

sld = uislider(___,Name,Value)는 위에 열거된 구문에 나와 있는 입력 인수 조합 외에, 이름-값 인수를 하나 이상 사용하여 Slider 속성을 지정합니다. 예를 들어, uislider("Value",50)은 값을 50으로 설정하여 슬라이더를 만듭니다.

예제

슬라이더 만들기

UI Figure에 슬라이더 컴포넌트를 만듭니다.

fig = uifigure;
sld = uislider(fig);

범위 슬라이더 만들기

UI Figure에 범위 슬라이더를 만듭니다.

fig = uifigure;
sld = uislider(fig,"range");

세로 슬라이더 만들기

UI Figure에 세로 슬라이더를 만듭니다.

fig = uifigure;
sld = uislider(fig,"Orientation","vertical");

슬라이더 속성 설정 및 액세스하기

UI Figure에 슬라이더를 만듭니다. 슬라이더 값을 50으로 설정합니다.

fig = uifigure;
sld = uislider(fig,"Value",50);

현재 슬라이더 제한을 결정합니다.

limits = sld.Limits

limits = 1×2

     0   100

슬라이더 제한을 변경하고 값을 35로 설정합니다.

sld.Limits = [-50 50];
sld.Value = 35;

슬라이더 눈금 구성하기

UI Figure에 슬라이더를 만듭니다.

fig = uifigure;
sld = uislider(fig);

슬라이더 모양을 사용자 지정합니다. 화씨 온도와 일치하도록 제한과 주 눈금을 업데이트하고 보조 눈금을 제거합니다.

sld.Limits = [32 212];
sld.MajorTicks = [32 100 150 212];
sld.MajorTickLabels = sld.MajorTicks + "°F";
sld.MinorTicks = [];

슬라이더 핸들 이동에 대한 코드 반응

슬라이더와 계기판이 있는 앱을 만듭니다. 앱 사용자가 슬라이더 핸들을 움직인 다음 마우스 버튼을 놓으면 계기판 바늘이 슬라이더 값을 반영하여 업데이트됩니다.

sliderApp.m이라는 파일에 다음과 같이 앱을 구현하는 함수를 작성합니다.

• UI Figure와 그리드 레이아웃 관리자를 만들어 앱의 레이아웃을 설정합니다.

• 그리드 레이아웃 관리자에서 계기판과 슬라이더를 만듭니다.

• 슬라이더 값과 일치하도록 계기판 값을 변경하는 updateGauge라는 콜백 함수를 작성한 다음, 이 함수를 슬라이더의 ValueChangedFcn 콜백 속성에 할당합니다. 콜백에 대한 자세한 내용은 프로그래밍 방식으로 만든 앱에 대한 콜백 만들기 항목을 참조하십시오.

function sliderApp
fig = uifigure("Position",[100 100 300 250]);
g = uigridlayout(fig);
g.RowHeight = {'1x','fit'};
g.ColumnWidth = {'1x','fit','1x'};

cg = uigauge(g);
cg.Layout.Row = 1;
cg.Layout.Column = [1 3];

sld = uislider(g, ...
    "ValueChangedFcn",@(src,event)updateGauge(src,event,cg));
sld.Layout.Row = 2;
sld.Layout.Column = 2;
end

function updateGauge(src,event,cg)
cg.Value = event.Value;
end

sliderApp 함수를 실행한 다음 슬라이더 핸들을 움직입니다. 핸들을 놓으면 계기판의 값이 업데이트됩니다.

sliderApp

슬라이더 핸들 이동에 대한 코드 반응

플롯과 범위 슬라이더가 있는 앱을 만듭니다. 앱 사용자가 슬라이더 핸들 중 하나를 움직이면 플롯의 음영 처리된 영역이 범위 슬라이더 값을 반영하여 업데이트됩니다.

rangeSliderApp.m이라는 파일에 다음과 같이 앱을 구현하는 함수를 작성합니다.

• UI Figure와 그리드 레이아웃 관리자를 만들어 앱의 레이아웃을 설정합니다.

• 그리드 레이아웃 관리자에서 UI 좌표축과 범위 슬라이더를 만듭니다. UI 좌표축에 데이터를 플로팅하고 채워진 영역을 만들어서 데이터의 일부를 강조 표시합니다.

• 범위 슬라이더 값과 일치하도록 채워진 영역의 범위를 업데이트하는 updateRange라는 콜백 함수를 작성한 다음, 이 함수를 범위 슬라이더의 ValueChangingFcn 콜백 속성에 할당합니다. 콜백에 대한 자세한 내용은 프로그래밍 방식으로 만든 앱에 대한 콜백 만들기 항목을 참조하십시오.

function rangeSliderApp
fig = uifigure;
g = uigridlayout(fig);
g.RowHeight = {'1x','fit'};
g.ColumnWidth = {'1x'};

ax = uiaxes(g);
plot(ax,peaks);
xr = xregion(ax,10,35);

sld = uislider(g,"range", ...
    "Limits",[0 50], ...
    "Value",[10 35]);

sld.ValueChangingFcn = @(src,event) updateRange(src,event,xr);
end

function updateRange(src,event,xr)
val = event.Value;
xr.Value = val;
end

rangeSliderApp 함수를 실행한 다음 슬라이더 핸들을 움직입니다. 핸들 중 하나를 끌면 좌표축의 채워진 영역이 업데이트됩니다.

입력 인수

style — 슬라이더의 스타일

"slider" (디폴트 값) | "range"

슬라이더의 스타일로, 다음 값 중 하나로 지정됩니다.

• "slider" — 하나의 값을 지정하기 위한 하나의 핸들을 갖는 표준 슬라이더

• "range" — 값의 범위를 지정하기 위한 두 개의 핸들을 갖는 범위 슬라이더

parent — 부모 컨테이너

Figure 객체 (디폴트 값) | Tab 객체 | Panel 객체 | ButtonGroup 객체 | GridLayout 객체

부모 컨테이너로, Figure 객체나 그 자식 컨테이너인 Tab, Panel, ButtonGroup, GridLayout 중 하나로 지정됩니다. 부모 컨테이너를 지정하지 않을 경우 MATLAB은 uifigure 함수를 호출하여 부모 컨테이너 역할을 하는 새 Figure 객체를 만듭니다.

이름-값 인수

선택적 인수 쌍을 Name1=Value1,...,NameN=ValueN으로 지정합니다. 여기서 Name은 인수 이름이고 Value는 대응값입니다. 이름-값 인수는 다른 인수 뒤에 와야 하지만, 인수 쌍의 순서는 상관없습니다.

예: uislider(Limits=[0 50])은 최소 슬라이더 값을 0으로 지정하고 최대 슬라이더 값을 50으로 지정합니다.

R2021a 이전 릴리스에서는 쉼표를 사용하여 각 이름과 값을 구분하고 Name을 따옴표로 묶으십시오.

예: uislider("Limits",[0 50])은 최소 슬라이더 값을 0으로 지정하고 최대 슬라이더 값을 50으로 지정합니다.

슬라이더의 각 스타일은 서로 다른 속성 모음을 지원합니다. 전체 속성 목록과 각 스타일에 대한 설명을 보려면 관련 속성 페이지를 참조하십시오.

• style이 디폴트 값("slider")인 경우 Slider 항목을 참조하십시오.

• style이 "range"인 경우 RangeSlider 항목을 참조하십시오.

버전 내역

R2016a에 개발됨

R2025a: 표준 슬라이더 스텝 크기 지정

표준 슬라이더를 만들 때 Step 속성을 사용하여 사용자가 슬라이더 핸들과 상호 작용할 때 값이 변경되는 정도를 지정할 수 있습니다.

R2024a: 범위 슬라이더 스텝 크기 지정

범위 슬라이더를 만들 때 Step 속성을 사용하여 사용자가 슬라이더 핸들과 상호 작용할 때 값이 변경되는 정도를 지정할 수 있습니다.

R2023b: 값 범위를 지정하는 슬라이더 만들기

style을 "range"로 지정하여 범위 슬라이더를 만듭니다.

참고 항목

함수

• uifigure

속성

• Slider | RangeSlider

툴

• 앱 디자이너