uiswitch

슬라이더 스위치, 로커 스위치 또는 토글 스위치 컴포넌트 만들기

구문

s = uiswitch

s = uiswitch(parent)

s = uiswitch(style)

s = uiswitch(parent,style)

sw = uiswitch(___,Name,Value)

설명

s = uiswitch는 새 Figure에 슬라이더 스위치를 만들고 Switch 객체를 반환합니다. MATLAB^®은 uifigure 함수를 호출하여 Figure를 만듭니다.

s = uiswitch(parent)는 지정된 부모 컨테이너에 스위치를 만듭니다. 부모 컨테이너는 Figure 객체이거나 그 자식 컨테이너 중 하나일 수 있습니다.

s = uiswitch(style)은 지정된 스타일의 스위치를 만듭니다. 스위치 스타일은 "slider", "rocker" 또는 "toggle"일 수 있습니다.

s = uiswitch(parent,style)은 지정된 부모 컨테이너에 지정된 스타일의 스위치를 만듭니다.

sw = uiswitch(___,Name,Value)는 위에 열거된 구문에 나와 있는 입력 인수 조합 외에, 이름-값 인수를 하나 이상 사용하여 스위치 속성을 지정합니다. 예를 들어 uiswitch("FontWeight","bold")는 레이블 텍스트가 굵게 표시된 스위치를 만듭니다.

예제

슬라이더 스위치 만들기

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

fig = uifigure("Position",[100 100 300 300]);
s = uiswitch(fig);

토글 스위치 만들기

UI Figure에 토글 스위치를 만듭니다.

fig = uifigure("Position",[100 100 300 300]);
ts = uiswitch(fig,"toggle");

패널에 로커 스위치 만들기

UI Figure와 패널을 만듭니다. 패널을 부모 컨테이너로 지정하여 로커 스위치를 만듭니다.

fig = uifigure("Position",[100 100 300 300]);
p = uipanel(fig);
rs = uiswitch(p,"rocker");

스위치 속성 설정 및 액세스하기

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

fig = uifigure("Position",[100 100 300 300]);
s = uiswitch(fig);

Items 속성을 설정하여 스위치 레이블 텍스트를 변경합니다.

s.Items = ["Stop","Start"];

현재 스위치 값을 결정합니다.

val = s.Value

val = 
'Stop'

스위치 방향 지정하기

UI Figure에 가로 토글 스위치를 만듭니다.

fig = uifigure("Position",[100 100 300 300]);
ts = uiswitch(fig,"toggle","Orientation","horizontal");

스위치 값 변경에 대한 코드 반응

사용자가 로커 스위치 값을 켜거나 끌 경우 램프의 색을 변경하는 앱을 만듭니다.

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

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

• 그리드 레이아웃 관리자에서 램프와 로커 스위치를 만듭니다.

• 스위치 값에 따라 램프 색을 변경하는 updateLamp라는 콜백 함수를 작성한 다음, 이 함수를 스위치의 ValueChangedFcn 콜백 속성에 할당합니다. 콜백에 대한 자세한 내용은 프로그래밍 방식으로 만든 앱에 대한 콜백 만들기 항목을 참조하십시오.

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

lmp = uilamp(g);

s = uiswitch(g,"rocker");
s.Items = ["Go","Stop"];
s.ValueChangedFcn = @(src,event) updateLamp(src,event,lmp);
end

function updateLamp(src,event,lmp)
val = src.Value;
switch val
    case "Go"
        lmp.Color = "green";
    case "Stop"
        lmp.Color = "red";
end
end

updateLampColor 함수를 실행합니다. 스위치와 상호 작용하여 램프의 색을 변경합니다.

updateLampColor

입력 인수

parent — 부모 컨테이너

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

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

style — 스위치의 스타일

"slider" (디폴트 값) | "rocker" | "toggle"

스위치의 스타일로, 다음 표의 값으로 지정됩니다.

스타일	모양
"slider"
"rocker"
"toggle"

이름-값 인수

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

예: uiswitch(Items=["0","1"])은 두 개의 스위치 상태를 "0"과 "1"로 지정합니다

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

예: uiswitch("Items",["0","1"])은 두 개의 스위치 상태를 "0"과 "1"로 지정합니다

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

• Switch

• RockerSwitch

• ToggleSwitch

버전 내역

R2016a에 개발됨

R2023b: 항목 목록에 있는 컴포넌트 값의 인덱스에 액세스

ValueIndex 속성을 사용하여 항목 목록에 있는 컴포넌트 값의 인덱스에 액세스합니다.

참고 항목

함수

• uifigure

객체

• Switch | RockerSwitch | ToggleSwitch

툴

• 앱 디자이너