Main Content

이 번역 페이지는 최신 내용을 담고 있지 않습니다. 최신 내용을 영문으로 보려면 여기를 클릭하십시오.

uigetfile

파일 선택 대화 상자 열기

설명

file = uigetfile은 현재 폴더에 있는 파일을 나열하는 모달 대화 상자를 엽니다. 이 대화 상자에서 사용자는 파일 이름을 선택하거나 입력할 수 있습니다. 파일이 존재하고 유효한 경우 사용자가 열기를 클릭하면 uigetfile은 파일 이름을 반환합니다. 사용자가 취소 또는 창 닫기 버튼(X)을 클릭하면 uigetfile0을 반환합니다.

[file,path] = uigetfile은 사용자가 열기를 클릭하면 파일 이름과 파일에 대한 경로를 반환합니다. 사용자가 취소 또는 창 닫기 버튼(X)을 클릭하면 uigetfile은 두 출력 인수 모두에 대해 0을 반환합니다.

예제

[file,path,indx] = uigetfile은 사용자가 열기를 클릭하면 대화 상자에서 선택된 필터의 인덱스를 반환합니다.

예제

___ = uigetfile(filter)는 대화 상자에 표시할 파일을 필터링하는 파일 확장자를 지정합니다. 이 구문을 위에 열거된 구문의 모든 출력 인수 조합과 함께 사용하십시오.

일반적으로, 파일 확장자가 일치하는 파일만 표시됩니다. 일부 플랫폼에서 uigetfile은 필터와 일치하지 않는 파일을 표시하기도 하지만, 이러한 파일 이름은 흐리게 표시됩니다. 필터가 누락되었거나 비어 있으면 uigetfile은 디폴트 파일 형식 목록(예: 모든 MATLAB® 파일)을 사용합니다.

예제

___ = uigetfile(filter,title)은 대화 상자 제목을 지정합니다. 디폴트 파일 필터를 사용하여 필터링하되 사용자 지정 제목을 지정하려면 필터 값에 빈 따옴표를 사용하십시오. 예를 들어, 다음과 같이 합니다.

file = uigetfile('','Select a File')

예제

___ = uigetfile(filter,title,defname)파일 이름 필드 또는 대화 상자가 열리는 디폴트 폴더의 디폴트 파일 이름을 지정합니다.

예제

___ = uigetfile(___,'MultiSelect',mode)는 사용자가 여러 개의 파일을 선택할 수 있는지 여부를 지정합니다. 다중 파일 선택을 활성화하려면 모드를 'on'으로 설정하십시오. 기본적으로 이 모드는 'off'로 설정되어 있습니다.

Windows® 라이브러리는 여러 개의 폴더를 사용할 수 있습니다.

참고

대화 상자의 시각적인 특성은 코드를 실행하는 운영 체제에 따라 달라집니다. 예를 들어, 일부 운영 체제는 대화 상자에 제목 표시줄을 표시하지 않습니다. 대화 상자 제목을 uigetfile 함수로 전달하면 운영 체제는 제목을 표시하지 않습니다.

예제

모두 축소

대화 상자에서 선택된 파일의 전체 파일 명세를 표시합니다. disp 함수와 fullfile 함수를 사용하여 설명 텍스트를 추가하고 path 출력값과 file 출력값을 결합합니다.

[file,path] = uigetfile('*.m');
if isequal(file,0)
   disp('User selected Cancel');
else
   disp(['User selected ', fullfile(path,file)]);
end

File selection dialog box. The visible files are .m files and the file filter drop-down reads (*.m).

User selected H:\Documents\MyCode\surf.m

명령 창에서 설명 텍스트를 사용하여 필터 인덱스 선택 항목을 표시합니다. num2str 함수를 사용하여 숫자 필터 인덱스 값(indx)을 문자형 배열로 변환합니다. 이렇게 하면 이 값이 disp 함수에 대한 유효한 입력값이 됩니다.

[file,path,indx] = uigetfile;
if isequal(file,0)
   disp('User selected Cancel')
else
   disp(['User selected ', fullfile(path, file),... 
         ' and filter index: ', num2str(indx)])
end

File selection dialog box. The dialog shows files with various extensions, and the file filter drop-down contains the extensions types.

User selected H:\Documents\MyCode\peaks.fig and filter index: 3

'*. m'filter 입력 인수로 지정하여 대화 상자에서 .m 확장자를 갖는 파일만 표시합니다.

[file,path] = uigetfile('*.m');

File selection dialog box. The visible files are .m files and the file filter drop-down reads (*.m).

파일 필터 드롭다운 목록에서 파일 확장자 목록을 만듭니다. filter 입력 인수를 문자형 벡터로 구성된 셀형 배열로 전달하고 세미콜론으로 파일 확장자를 구분합니다.

[file,path] = uigetfile({'*.m';'*.slx';'*.mat';'*.*'},...
                          'File Selector');

File selection dialog box. The file filter drop-down has an option for each specified file extension, and (*.m) is selected. The visible files are .m files.

filter 입력 인수를 문자형 벡터로 구성된 셀형 배열로 전달하여 파일 확장자 목록을 만들고 이에 대한 설명을 지정합니다. 셀형 배열의 첫 번째 열에는 파일 확장자가 포함되고 두 번째 열에는 파일 형식의 사용자 지정 설명이 포함됩니다. 또한 이 예제에서는 'MATLAB Files''Models' 설명이 여러 파일 형식에 연결됩니다.

[file,path,indx] = uigetfile( ...
{'*.m;*.mlx;*.fig;*.mat;*.slx;*.mdl',...
    'MATLAB Files (*.m,*.mlx,*.fig,*.mat,*.slx,*.mdl)';
   '*.m;*.mlx','Code files (*.m,*.mlx)'; ...
   '*.fig','Figures (*.fig)'; ...
   '*.mat','MAT-files (*.mat)'; ...
   '*.mdl;*.slx','Models (*.slx, *.mdl)'; ...
   '*.*',  'All Files (*.*)'}, ...
   'Select a File');

File selection dialog box. The file filter drop-down lists the specified file filter descriptions. The visible files are .m and .fig files.

대화 상자가 열릴 때 파일 이름 필드에 디폴트 파일 이름을 표시하려면 파일 이름을 defname 입력 인수로 전달하십시오.

 [file,path] = uigetfile('*.png',...
               'Select an icon file','icon.png')

File selection dialog box. The title of the dialog box is Select an icon file and the default file name is icon.png. The visible files are .png files.

대화 상자가 열릴 때 디폴트 경로와 파일 이름을 파일 이름 필드에 표시하려면, 전체 파일 이름을 filter 입력 인수로 전달하십시오.

[file,path] = uigetfile('C:\Documents\Work\icon.png',...
                        'Select an Image File')

File selection dialog box. The title of the dialog box is Select an Image File. The dialog is open to the C:\Documents\Work folder and the default file name is icon.png. The visible files are .png files.

filter 입력 인수를 문자형 벡터로 구성된 셀형 배열로 전달하여 파일 확장자 목록을 만듭니다. 대화 상자가 열리는 폴더를 지정합니다.

[file,path] = uigetfile({'*.png';'*.m'},...
               'Select a file','C:\Documents\AppBuildingFiles\')

File selection dialog box. The title of the dialog box is Select a file. The dialog is open to the C:\Documents\AppBuildingFiles folder and the file filter drop-down contains a .png and a .m filter.

'Multiselect' 옵션을 'on'으로 설정하여 다중 파일 선택을 활성화합니다. 사용자는 Shift 키나 Ctrl 키를 누른 상태에서 파일 이름을 클릭하여 여러 개의 파일을 선택할 수 있습니다.

[file,path] = uigetfile('*.m',...
   'Select One or More Files', ...
   'MultiSelect', 'on');

File selection dialog box. The title of the dialog box is Select One or More Files. Multiple files in the dialog box are selected.

입력 인수

모두 축소

파일 필터로, 문자형 벡터, 문자형 벡터로 구성된 셀형 배열 또는 string형 배열로 지정됩니다. 아래 표는 filter 인수에 전달할 수 있는 입력 유형과 대화 상자에서의 동작을 나열합니다.

입력값동작예제
파일 이름

파일 이름은 대화 상자의 파일 이름 필드에 표시됩니다. 파일 확장자가 디폴트 필터 값입니다.

파일 이름에 경로가 포함된 경우 대화 상자가 지정된 폴더로 열립니다. 그렇지 않으면 현재 폴더로 열립니다. 지정한 폴더가 없으면 uigetfile은 대화 상자를 현재 폴더로 엽니다.

  • 'icon.png'

  • 'C:\Documents\icon.png'

  • '..\icon.png'

폴더

대화 상자는 폴더의 내용을 표시합니다. 파일 이름 필드는 비어 있으며 필터가 적용되지 않습니다. 폴더 이름을 지정하려면 filter의 마지막 문자가 백슬래시(\)이거나 슬래시(/)여야 합니다.

지정한 폴더가 없으면 uigetfile은 대화 상자를 현재 폴더로 엽니다.

  • 'C:\Documents\'

파일 확장자 필터

대화 상자에는 일치하는 확장자를 갖는 파일만 표시됩니다.

사용자가 여러 개의 필터 중에서 선택하도록 허용하려면 각 필터에 대한 항목이 있는 셀형 배열 또는 string형 배열을 지정합니다. 필터는 대화 상자의 필터 필드 드롭다운 메뉴에 표시됩니다.

2개 이상의 확장자로 필터를 생성하려면 단일 문자형 벡터 또는 string형 내에 확장자를 지정하고 세미콜론(;)으로 구분합니다.

  • '*.m'

  • {'*.m';'*.mlx'}

  • {'*.m;*.mlx';'*.png;*.jpeg'}

설명이 있는 파일 확장자 필터

대화 상자는 확장자를 필터 필드의 설명과 함께 표시합니다. 사용자는 여러 개의 필터 중에서 선택할 수 있습니다.

필터 설명을 표시하려면 셀형 배열 또는 string형 배열에서 두 개의 열을 지정합니다. 첫 번째 열에는 파일 확장자 목록이 포함됩니다. 두 번째 열에는 각 확장자의 설명 목록이 포함됩니다. 이러한 설명은 필터 필드의 표준 설명을 바꿉니다. 설명은 비어 있을 수 없습니다.

  • {'*.m;*.mlx','Code files';'*.png;*.jpeg','Image files'}

파일 필터에 경로가 포함된 경우, 해당 경로는 다음 문자를 포함할 수 있습니다.

  • .

  • ..

  • \

  • /

  • ~

예를 들어 '../*.m'은 현재 폴더 위에 있는 폴더에서 .m 확장자를 가진 모든 코드 파일을 나열합니다.

디폴트 파일 필터를 사용하려면 필터 값에 빈 따옴표를 지정하십시오. 예를 들어, 디폴트 파일 필터를 사용하고 사용자 지정 제목을 지정하려면 다음 구문을 사용하십시오.

uigetfile('','Select File')

참고

파일 이름에 별표(*) 또는 물음표(?)가 들어 있으면 열기 클릭 시 uigetfile이 응답하지 않습니다. 사용자가 취소를 클릭하거나 파일 이름에서 와일드카드 문자를 제거할 때까지 대화 상자는 그대로 열려 있습니다. 이 제한 사항은 파일 이름에 와일드카드 문자를 허용하는 파일 시스템까지 포함하여 모든 플랫폼에 적용됩니다.

대화 상자 제목으로, 문자형 벡터 또는 string형 스칼라로 지정됩니다.

디폴트 대화 상자 제목을 사용하려면 제목 값에 빈 따옴표를 사용하십시오. 예를 들어, 파일 필터, 디폴트 제목, 파일 이름 필드 값을 지정하려면 다음 구문을 사용하십시오.

uigetfile('*.m','','myFile.m')

예: "Select a File"

대화 상자가 열릴 때 파일 이름 필드에 표시할 디폴트 파일 이름으로, 문자형 벡터 또는 string형 스칼라로 지정됩니다. defname 값은 경로 또는 경로 및 파일 이름을 지정할 수 있습니다.

  • 경로를 지정할 경우, 다음 문자를 포함할 수 있습니다.

    • .

    • ..

    • \

    • /

    • ~

  • 폴더 이름만 지정하려면 defname 값의 마지막 문자를 백슬래시(\)나 슬래시(/)로 지정하십시오.

예: 'myfile.mat'

예: 'C:\Documents\my_MATLAB_files'

예: '..\myfile.mat'

예: '..\Documents\'

Multiselect 모드로, 'on' 또는 'off'로 지정됩니다. multiselect 모드가 꺼져 있으면 사용자는 한 개의 파일만 선택할 수 있습니다. multiselect 모드가 켜져 있으면 사용자는 여러 개의 파일을 선택할 수 있습니다. 사용자가 여러 개의 파일을 선택하는 경우 그 파일들은 같은 폴더에 있어야 합니다. 그렇지 않으면 MATLAB이 경고 대화 상자를 표시합니다. Microsoft® Windows 라이브러리는 여러 개의 폴더를 사용할 수 있습니다.

출력 인수

모두 축소

사용자가 대화 상자에서 지정한 파일 이름으로, 문자형 벡터 또는 문자형 벡터로 구성된 셀형 배열로 반환됩니다.

'MultiSelect''on'으로 설정되어 있고 사용자가 여러 개의 파일을 선택하면 문자형 벡터로 구성된 셀형 배열이 반환됩니다. 각 배열 요소에는 선택한 파일 이름이 포함됩니다. 셀형 배열의 파일 이름은 사용자 플랫폼별 정렬 방식에 맞게 배열됩니다. 사용자가 여러 개의 파일을 선택하는 경우 그 파일들은 같은 폴더에 있어야 합니다. 그렇지 않으면 MATLAB이 경고 대화 상자를 표시합니다.

사용자가 취소 버튼 또는 창 닫기 버튼(X)을 클릭하면 MATLAB은 파일 값을 0으로 반환합니다.

지정된 하나 또는 여러 파일에 대한 경로로, 문자형 벡터로 반환됩니다.

사용자가 취소 버튼 또는 창 닫기 버튼(X)을 클릭하면 MATLAB은 파일 값을 0으로 반환합니다.

선택된 필터 인덱스로, 정수로 반환됩니다.

필터는 대화 상자에서 파일 이름 필드의 오른쪽에 있는 레이블이 지정되지 않은 대화 상자 컨트롤입니다. 필터 인덱스 값은 필터 드롭다운 목록에서 선택한 항목에 대응합니다. 첫 번째 행의 인덱스는 1입니다.

File name field and drop-down list. The drop-down list contains multiple options for file extension filters.

사용자가 취소 버튼 또는 창 닫기 버튼(X)을 클릭하면 MATLAB은 인덱스 값 0을 반환합니다.

세부 정보

모두 축소

모달 대화 상자

모달 대화 상자에서는 대화 상자 조작이 끝나기 전에 다른 MATLAB 창과 상호 작용을 할 수 없습니다.

  • MATLAB과 MATLAB 툴박스의 다양한 입력 함수와 출력 함수를 사용하여 파일을 열고, 읽거나 분석하려면 uigetfile이 반환하는 경로와 파일 이름을 사용하십시오. 예를 들면 다음과 같습니다.

    • imread로 이미지를 읽을 수 있습니다.

    • xlsread로 Microsoft Excel 파일을 읽을 수 있습니다.

    • MATLAB 코드 파일에서 open, edit 또는 run을 실행할 수 있습니다. 예를 들어, 다음 코드는 사용자로부터 MATLAB 코드 파일 이름을 가져오는 대화 상자를 만들고, 반환된 값에서 전체 파일 이름을 작성한 다음, 사용자가 지정한 코드 파일을 실행합니다.

      [file,path] = uigetfile('*.m');
      selectedfile = fullfile(path,file);
      run(selectedfile);
      

대체 기능

현재 폴더나 지정한 폴더에서 필터링되거나 필터링되지 않은 파일 목록을 반환하려면 dir 함수를 사용하십시오. dir 함수는 파일 특성도 반환할 수 있습니다.

버전 내역

R2006a 이전에 개발됨

참고 항목

| |