Main Content

このページの内容は最新ではありません。最新版の英語を参照するには、ここをクリックします。

imgetfile

Open Image ダイアログ ボックスを表示

説明

[filename,user_canceled] = imgetfile は Open Image ダイアログ ボックスを表示します。イメージング アプリケーションでこのダイアログ ボックスを使用し、開くイメージ ファイルの名前を取得します。[イメージを開く] ダイアログ ボックスには、サポートされているイメージ ファイル形式 (imformats を参照) を使用するファイルと DICOM ファイルのみが含まれています。

ファイルを選択して [開く] をクリックすると、imgetfilefilename でファイルの絶対パスを返し、user_canceled の戻り値を false に設定します。[キャンセル] をクリックすると、imgetfilefilename で空の文字ベクトル ('') を返し、user_canceled の戻り値を true に設定します。

メモ

[イメージを開く] ダイアログ ボックスはモーダルです。すなわち、応答があるまで MATLAB® のコマンド ラインはブロックされます。

[filename,user_canceled] = imgetfile(Name=Value) は、その動作の特性を制御する場合に使用できる名前と値の引数をサポートします。

すべて折りたたむ

[イメージを開く] ダイアログ ボックスを開き、Image Processing Toolbox™ のサンプル イメージを含むフォルダーを表示します。

sample_image_folder = fullfile(matlabroot,"toolbox/images/imdata");

[filename,user_canceled] = imgetfile(InitialPath=sample_image_folder)

リストにあるイメージを選択して [開く] をクリックします。imgetfile は選択されたイメージ ファイルの絶対パスを文字ベクトルとして返します。user_canceled の値は false です。

filename =

C:\Program Files\MATLAB\R2016b\toolbox\images\imdata\cameraman.tif


user_canceled =

  logical

   0

[イメージを開く] ダイアログ ボックスを開きます。この例では、システムの C: ドライブにサンプル イメージの格納フォルダーがあると想定しています。

[filename,user_canceled] = imgetfile(InitialPath="C:\Temp\SampleImages", ...
    MultiSelect=true)

Shift キーを押しながらクリックするか、Ctrl キーを押しながらクリックして、リスト内のイメージを複数選択します。

[開く] をクリックします。imgetfile は各イメージ ファイルの絶対パスを含む文字ベクトルの cell 配列を返します。user_canceled の値は false です。

filename =

  1×5 cell array

  Columns 1 through 3

    'C:\Temp\SampleIma…'    'C:\Temp\SampleIma…'    'C:\Temp\SampleIma…'

  Columns 4 through 5

    'C:\Temp\SampleIma…'    'C:\Temp\SampleIma…'


user_canceled =

  logical

   0

入力引数

すべて折りたたむ

名前と値の引数

オプションの引数のペアを Name1=Value1,...,NameN=ValueN として指定します。ここで、Name は引数名で、Value は対応する値です。名前と値の引数は他の引数の後に指定しなければなりませんが、ペアの順序は重要ではありません。

例: [fname,user_canc] = imgetfile(InitialPath="C:\temp") は、初期パスを "C:\temp" として指定します。

R2021a より前では、コンマを使用して名前と値をそれぞれ区切り、Name を引用符で囲みます。

例: [fname,user_canc] = imgetfile("InitialPath","C:\temp") は、初期パスを "C:\temp" として指定します。

[イメージを開く] ダイアログ ボックスを開いたときに表示されるフォルダー。string スカラーまたは文字ベクトルとして指定します。パスの初期値を指定しない場合、imgetfile はイメージが正常に選択された最後の場所でダイアログ ボックスを開きます。

データ型: char

選択モード。"on" または "off"、あるいは logical の true または false として指定します。値 true または "on" により複数選択をオンにすると、ダイアログ ボックスで Shift キーを押しながらクリックするか、Ctrl キーを押しながらクリックして複数のイメージを選択できます。値 false または "off" は複数選択をオフにします。複数選択がオンの場合、出力パラメーター filename は選択されたファイルの絶対パスを含む文字ベクトルの cell 配列になります。

データ型: logical | char

出力引数

すべて折りたたむ

ユーザーによって選択されたイメージ (複数可) の絶対パス。文字ベクトルまたは文字ベクトルの cell 配列として返されます。ユーザーが [キャンセル] をクリックした場合、filename は空の文字ベクトル ('') になります。

ユーザーのクリックによるキャンセル。logical スカラーとして返されます。ユーザーが [キャンセル] をクリックすると、値は true になり、ユーザーがイメージ (複数可) を選択すると、値は false になります。

バージョン履歴

R2006a より前に導入