Main Content

uibutton

누름 버튼 또는 상태 버튼 컴포넌트 생성

페이지 내 모두 축소

구문

btn = uibutton
btn = uibutton(parent)
btn = uibutton(style)
btn = uibutton(parent,style)
btn = uibutton(___,Name,Value)

설명

btn = uibutton은 새 Figure에 누름 버튼을 만들고 Button 객체를 반환합니다. MATLAB®은 uifigure 함수를 호출하여 Figure를 만듭니다.

예제

btn = uibutton(parent)는 지정된 부모 컨테이너에 버튼을 만듭니다. 부모 컨테이너는 uifigure 함수를 사용하여 만든 Figure이거나 그 자식 컨테이너 중 하나일 수 있습니다.

btn = uibutton(style)은 지정된 스타일의 버튼을 만듭니다. 버튼 스타일은 "push" 또는 "state"일 수 있습니다.

예제

btn = uibutton(parent,style)은 지정된 부모 컨테이너에 지정된 스타일의 버튼을 만듭니다.

예제

btn = uibutton(___,Name,Value)는 하나 이상의 이름-값 인수로 지정된 속성이 있는 버튼을 만듭니다. 예를 들어, BackgroundColor 속성을 사용하여 버튼 배경색을 지정합니다. 위에 열거된 구문에 나와 있는 입력 인수를 조합하여 이 옵션과 함께 사용하십시오.

예제

모두 축소

라이브 스크립트 열기

UI Figure에 누름 버튼을 만듭니다.

fig = uifigure;
b = uibutton(fig);

Figure contains an object of type uibutton.

라이브 스크립트 열기

UI Figure에 상태 버튼을 만듭니다.

fig = uifigure;
b = uibutton(fig,"state");

Figure contains an object of type uistatebutton.

버튼을 클릭합니다. 클릭한 후에 버튼이 눌린 상태로 유지됩니다.

State button in a UI figure. The button is in a pressed state.

라이브 스크립트 열기

UI Figure에 상태 버튼을 만든 다음, 속성값을 지정하여 상태 버튼의 모양을 사용자 지정합니다.

fig = uifigure;
b = uibutton(fig,"state", ...
    "Text","Play", ...
    "Icon","play.png", ...
    "IconAlignment","top", ...
    "Position",[100 100 50 50]);

Figure contains an object of type uistatebutton.

상태 버튼이 눌린 상태인지 여부를 확인합니다.

b.Value
ans = logical
   0

버튼이 눌린 상태로 표시되도록 버튼 값을 프로그래밍 방식으로 업데이트합니다.

b.Value = true;

Figure contains an object of type uistatebutton.

라이브 스크립트 열기

앱 사용자가 버튼을 누를 때 일부 데이터를 플로팅하는 앱을 만듭니다.

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

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

  • 그리드 레이아웃 관리자에서 UI 좌표축과 버튼을 만듭니다.

  • UI 좌표축에 일부 데이터를 플로팅하는 plotButtonPushed라는 콜백 함수를 작성한 다음, 이 함수를 ButtonPushedFcn 콜백 속성에 할당합니다. 콜백에 대한 자세한 내용은 프로그래밍 방식으로 만든 앱에 대한 콜백 만들기 항목을 참조하십시오.

function plotApp
fig = uifigure;
g = uigridlayout(fig,[2 3]);
g.RowHeight = {'1x','fit'};
g.ColumnWidth = {'1x','fit','1x'};


ax = uiaxes(g);
ax.Layout.Row = 1;
ax.Layout.Column = [1 3];
b = uibutton(g, ...
    "Text","Plot Data", ...
    "ButtonPushedFcn", @(src,event) plotButtonPushed(ax));
b.Layout.Row = 2;
b.Layout.Column = 2;
end

function plotButtonPushed(ax)
x = linspace(0,2*pi,100);
y = sin(x);
plot(ax,x,y)
end

plotApp 함수를 실행합니다. 버튼을 클릭하여 데이터를 플로팅합니다.

UI figure window with axes showing some plotted data and a Plot Data button below the axes

입력 인수

모두 축소

버튼 스타일로, 다음 값 중 하나로 지정됩니다.

  • "push" — 한 번 클릭하면 버튼을 눌렀다가 놓은 상태가 됩니다.

  • "state" — 한 번 클릭하면 다시 클릭할 때까지 버튼이 눌린 상태 또는 놓은 상태로 유지됩니다.

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

이름-값 인수

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

예: uibutton(fig,BackgroundColor="blue")

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

예: uibutton(fig,"BackgroundColor","blue")

각 유형의 Button 객체는 서로 다른 속성 모음을 지원합니다. 전체 속성 목록과 각 유형에 대한 설명을 보려면 관련 속성 페이지를 참조하십시오.

  • style이 "push"(디폴트 값)인 경우 Button 속성 항목을 참조하십시오.

  • style이 "state"인 경우 StateButton 속성 항목을 참조하십시오.

버전 내역

R2016a에 개발됨

모두 확장

참고 항목

함수

속성

툴