hgload
ファイルからのグラフィックス オブジェクト階層の読み込み
構文
h = hgload(filename)
[h,old_prop_values] = hgload(...,property_structure)
説明
メモ
hgload
は推奨されません。代わりに openfig
を使用してください。
警告
セキュリティについての考慮事項: 関数 hgload
は、グラフィックス オブジェクトを読み取る際に、FIG ファイルに含まれるコードを実行する可能性があります。信頼されていない FIG ファイルに対して hgload
を呼び出すことは避けてください。
h = hgload(filename)
は filename
で指定された FIG ファイルからグラフィックス オブジェクト階層を読み込み、最上位オブジェクトのハンドルを返します。filename
は文字ベクトルまたは string として指定します。filename
に拡張子が付いていない場合、MATLAB® は、拡張子 .fig
を付けます。
[h,old_prop_values] = hgload(...,property_structure)
は FIG ファイルに格納されている最上位オブジェクトのプロパティを property_structure
の値でオーバーライドし、以前の値を old_prop_values
に返します。
property_structure
は、プロパティ名に対応するフィールド名と新しいプロパティ値をもつ構造体でなければなりません。
old_prop_values
は、h
と同じ長さをもつ cell 配列で、個々のオブジェクトに対して書き換えたプロパティの古い値を含んだものです。個々のセルは、構造体で、構造体のフィールド名がプロパティ名で、それぞれには、変更された個々のプロパティの元の値を含んでいます。property_structure
に指定されているプロパティの中で、FIG ファイルの中のトップレベル オブジェクトのプロパティでないものについては、old_prop_values
に含まれていません。
シリアル化できないオブジェクト (既定のツール バーや既定のメニューなど) は Figure 作成時に作成されるため、保存されません。再読み込みは、既存の FIG ファイルに影響を与えない、既定のメニューやツール バーの改訂を行うことができます。
代替方法
Figure ウィンドウ メニューで [ファイル]、[開く] を使用して、[開く] ダイアログで Figure ファイルにアクセスします。
バージョン履歴
R2006a より前に導入