Main Content

dialog

빈 모달 대화 상자 생성

설명

d = dialog는 빈 대화 상자를 만들고 Figure 객체 d를 반환합니다. uicontrol 함수를 사용하여 사용자 인터페이스 컨트롤을 대화 상자에 추가하십시오.

예제

d = dialog(Name,Value)는 하나 이상의 Figure 속성 이름과 대응값을 지정합니다. 이 구문을 사용하여 디폴트 속성을 재정의할 수 있습니다.

예제

모두 축소

uicontrol 함수를 사용하여 사용자 인터페이스 컨트롤을 대화 상자에 추가할 수 있습니다. 예를 들어, 텍스트와 버튼을 포함하는 대화 상자를 표시하는 mydialog.m이라는 프로그램 파일을 만듭니다.

function mydialog
    d = dialog('Position',[300 300 250 150],'Name','My Dialog');

    txt = uicontrol('Parent',d,...
               'Style','text',...
               'Position',[20 80 210 40],...
               'String','Click the close button when you''re done.');

    btn = uicontrol('Parent',d,...
               'Position',[85 20 70 25],...
               'String','Close',...
               'Callback','delete(gcf)');
end

그런 다음, 명령 창에서 mydialog 함수를 실행합니다.

mydialog

Dialog box with the title "My Dialog, the text "Click the close button when you're done", and a button labeled "Close"

uiwait 함수를 사용하여 대화 상자에서 사용자가 선택한 항목을 바탕으로 출력값을 반환할 수 있습니다. 예를 들어, 다음 작업을 수행하는 choosedialog.m이라는 프로그램 파일을 만듭니다.

  • dialog 함수를 호출하여 특정 크기와 위치, 그리고 "Select One"이라는 제목을 가진 대화 상자를 만듭니다.

  • uicontrol 함수를 세 번 호출하여 텍스트, 팝업 메뉴, 버튼을 각각 추가합니다.

  • 함수 popup_callback을 버튼에 대한 콜백 함수로 동작하도록 정의합니다.

  • 명령줄에서 출력값을 반환하기 전에 uiwait 함수를 호출하여 사용자가 대화 상자를 닫을 때까지 기다립니다.

function choice = choosedialog

    d = dialog('Position',[300 300 250 150],'Name','Select One');
    txt = uicontrol('Parent',d,...
           'Style','text',...
           'Position',[20 80 210 40],...
           'String','Select a color');
       
    popup = uicontrol('Parent',d,...
           'Style','popup',...
           'Position',[75 70 100 25],...
           'String',{'Red';'Green';'Blue'},...
           'Callback',@popup_callback);
       
    btn = uicontrol('Parent',d,...
           'Position',[89 20 70 25],...
           'String','Close',...
           'Callback','delete(gcf)');
       
    choice = 'Red';
       
    % Wait for d to close before running to completion
    uiwait(d);
   
       function popup_callback(popup,event)
          idx = popup.Value;
          popup_items = popup.String;
          choice = char(popup_items(idx,:));
       end
end

명령 창에서 choosedialog 함수를 실행합니다. 그런 다음, 대화 상자에서 색을 선택합니다.

color = choosedialog

Dialog box with the title "Select One", the text "Select a color", a drop-down list with the option "Blue" selected, and a button labeled "Close"

대화 상자를 닫으면 choosedialog가 마지막으로 선택한 색을 반환합니다.

color =

Blue

참고

uiwait 함수는 MATLAB® 스레드를 차단합니다. uiwait는 단순한 모달 대화 상자에서 잘 작동하지만, 보다 복잡한 애플리케이션에서는 사용하지 않는 것이 좋습니다.

입력 인수

모두 축소

이름-값 인수

예: dialog('WindowStyle','normal')WindowStyle 속성을 'normal'로 설정합니다.

여기에 나와 있는 속성은 일부에 불과합니다. 전체 목록을 보려면 Figure 속성를 참조하십시오.

그리기 가능 영역의 위치와 크기로, [left bottom width height] 형식의 벡터로 지정됩니다. Figure 테두리, 제목 표시줄, 메뉴 모음, 도구 모음은 이 영역에서 제외됩니다.

다음 표에서는 Position 벡터의 각 요소를 설명합니다.

요소설명
left주 디스플레이의 왼쪽 가장자리부터 창의 왼쪽 내부 가장자리까지의 거리. 둘 이상의 모니터를 사용하는 시스템에서는 이 값이 음수일 수 있습니다.

Figure가 도킹된 경우 이 값은 MATLAB 데스크탑 내의 Figure 패널에 대해 상대적입니다.
bottom주 디스플레이의 하단 가장자리부터 창의 내부 하단 가장자리까지의 거리. 둘 이상의 모니터를 사용하는 시스템에서는 이 값이 음수일 수 있습니다.

Figure가 도킹된 경우 이 값은 MATLAB 데스크탑 내의 Figure 패널에 대해 상대적입니다.
widthdialog의 오른쪽과 왼쪽 내부 가장자리 사이의 거리.
height창의 상단과 하단 내부 가장자리 사이의 거리.

모든 측정값은 Units 속성으로 지정된 단위로 표시됩니다.

Figure가 도킹되어 있으면 Figure의 Position 속성을 지정할 수 없습니다.

MATLAB Online™에서는 Position 벡터의 bottom 요소와 left 요소가 무시됩니다.

테두리, 제목 표시줄, 메뉴 모음, 도구 모음을 포함하는 완전한 창을 배치하려면 OuterPosition 속성을 사용하십시오.

참고

Windows® 운영 체제에서는 최소 창 너비와 최대 창 크기가 강제로 적용됩니다. 이 제한값을 벗어나는 Figure 크기를 지정할 경우 Figure는 사용자가 지정한 크기가 아니라 이 제한 크기로 표시됩니다.

버튼 누름 콜백으로, 다음 값 중 하나로 지정됩니다.

  • 함수 핸들.

  • 첫 번째 요소가 함수 핸들인 셀형 배열. 이 셀형 배열의 그 다음 요소들은 콜백 함수로 전달할 인수입니다.

  • 유효한 MATLAB 표현식이 포함된 문자형 벡터(권장되지 않음). MATLAB은 이 표현식을 기본 작업 공간에서 실행합니다.

이 콜백은 사용자가 Figure의 빈 영역을 클릭할 때마다 실행됩니다.

콜백 속성값을 함수 핸들, 셀형 배열 또는 문자형 벡터로 지정하는 방법에 대한 자세한 내용은 콜백 함수 지정하기 항목을 참조하십시오.

SelectionType 속성을 사용하여 사용자가 보조키를 눌렀는지 확인합니다.

창 스타일로, 다음 중 하나로 지정됩니다.

  • 'modal' — Figure는 기존의 모든 Figure 창 위에 표시되어, 맨 앞 Figure가 모달 상태로 존재하는 한 기존 Figure에 액세스할 수 없게 됩니다. 그러나 모달 Figure 이후에 새로 생성된 Figure는 모두 표시됩니다.

    여러 모달 창이 있는 경우 가장 최근에 생성된 창에 포커스가 유지되며, 이 가장 최근에 생성된 창은 숨겨지도록 설정되거나 일반 창 스타일로 돌아가거나 삭제될 때까지 다른 모든 창 위에 계속 남아 있습니다. 창이 사라지거나 WindowStyle normal로 돌아가거나 삭제되면 포커스는 마지막으로 포커스가 있던 창으로 복귀됩니다.

  • 'normal' — Figure 창은 다른 창에 독립적이며, Figure가 표시되는 동안 다른 창에 액세스할 수 있습니다.

  • 'docked' — Figure가 데스크탑 또는 문서 창에 표시됩니다. WindowStyle 속성이 'docked'로 설정되어 있으면 DockControls 속성을 'off'로 설정할 수 없습니다. MATLAB Online에서는 'docked' 옵션이 지원되지 않습니다.

참고

다음은 WindowStyle 속성의 몇 가지 중요한 특성과 권장되는 모범 사례입니다.

  • UI 창을 만들 때는 항상 WindowStyle 속성을 지정하십시오. 또한 Figure의 Resize, Position, OuterPosition 속성 중 하나를 설정하려는 경우에는 먼저 WindowStyle 속성을 설정하십시오.

  • Figure의 WindowStyle 속성은 Figure가 표시되도록 설정되거나 Figure에 자식이 포함된 경우 등 언제든지 사용자가 변경할 수 있습니다. 그러나 일부 시스템에서는 이 속성을 설정하면 시스템의 일반 창과 모달 창 구현 방식에 따라 Figure가 깜박이거나 사라졌다가 다시 나타날 수 있습니다. 최적의 시각적 결과를 얻으려면 생성 시에 또는 Figure가 표시되지 않을 때 WindowStyle 속성을 설정하십시오.

  • Figure에서 reset을 호출해도 WindowStyle 속성의 값은 변경되지 않습니다.

모달 창 스타일 동작

WindowStyle'modal'로 설정된 경우, Figure 창은 창이 표시되어 있는 한 모든 MATLAB 창에 대한 모든 키보드와 마우스 동작을 트래핑합니다. MATLAB이 아닌 다른 애플리케이션에 속해 있는 창에는 영향을 미치지 않습니다.

모달 Figure에 포커스가 있는 상태에서 Ctrl+C를 입력하면 해당 Figure는 'normal' WindowStyle 속성 설정으로 되돌아갑니다. 따라서 사용자가 명령줄에 입력할 수 있습니다.

WindowStyle 속성이 'modal'로 설정되고 Visible 속성이 'off'로 설정된 Figure는 MATLAB에서 표시 가능해질 때까지 모달 형식으로 동작하지 않습니다. 따라서 모달 창을 삭제하는 대신 나중에 재사용할 수 있도록 숨겨둘 수 있습니다.

모달 Figure는 메뉴의 자식, 내장 메뉴 또는 도구 모음을 표시하지 않습니다. 그러나 모달 Figure에서 메뉴를 만들거나 메뉴의 자식이 있는 Figure에서 WindowStyle 속성 설정을 'modal'로 변경하는 것은 오류가 아닙니다. 이유는, Menu 객체가 존재하고 있으며 Figure가 이를 유지하기 때문입니다. Figure의 WindowStyle 속성을 'normal'로 재설정하면 메뉴가 표시됩니다.

출력 인수

모두 축소

대화 상자 창으로, 다음 속성값이 설정된 Figure 객체로 반환됩니다.

속성
ButtonDownFcn'if isempty(allchild(gcbf)), close(gcbf), end'
Colormap[]
DockControls'off'
HandleVisibility'callback'
IntegerHandle'off'
InvertHardcopy'off'
MenuBar'none'
Number[]
NumberTitle'off'
PaperPositionMode'auto'
Resize'off'
WindowStyle'modal'

버전 내역

R2006a 이전에 개발됨

참고 항목

함수

속성