ドキュメンテーション

最新のリリースでは、このページがまだ翻訳されていません。 このページの最新版は英語でご覧になれます。

figure

Figure ウィンドウの作成

説明

figure は、既定のプロパティ値を使用して、新しい Figure ウィンドウを作成します。結果の Figure は、現在の Figure になります。

figure(Name,Value) は 1 つ以上の名前と値のペアの引数を使用して、Figure のプロパティを変更します。たとえば、figure('Color','white') は背景色を白に設定します。

f = figure(___) は、Figure オブジェクトを返します。f は、Figure を作成した後でそのプロパティのクエリや変更に使用します。

figure(f) は、f で指定された Figure を現在の Figure にして、他のすべての Figure の前面に表示します。

figure(n) は、Number プロパティが n と等しい Figure を検出して、現在の Figure にします。そのプロパティ値をもつ Figure が存在しない場合、MATLAB® は新しい Figure を作成し、その Number プロパティを n に設定します。

すべて折りたたむ

Figure を作成して、Name プロパティを指定します。既定では、生成されるタイトルには、Figure の番号が含まれます。

figure('Name','Measured Data');

Name プロパティを再び指定します。ただし、今回は NumberTitle プロパティを 'off' に設定します。生成されるタイトルに Figure の番号は含まれません。

figure('Name','Measured Data','NumberTitle','off');

2 つの Figure を作成してから、ライン プロットを作成します。plot コマンドの既定のターゲットは現在の Figure です。

f1 = figure;
f2 = figure;
plot([1 2 3],[2 4 6]);

現在の Figure を f1 に設定して、次のプロットのターゲットにします。その後、散布図を作成します。

figure(f1);
scatter((1:20),rand(1,20));

入力引数

すべて折りたたむ

ターゲット Figure。Figure オブジェクトとして指定します。

ターゲット Figure の番号。スカラー整数値として指定します。この引数を指定した場合、MATLAB は Number プロパティが n と等しい既存の Figure を検索します。そのプロパティ値をもつ Figure が存在しない場合、MATLAB は新しい Figure を作成し、その Number プロパティを n に設定します。既定で Number プロパティ値は、Figure のタイトルに表示されます。

データ型: double

名前と値のペアの引数

例: figure('Color','white') は、白の背景色をもつ Figure を作成します。

オプションの Name,Value の引数ペアをコンマ区切りで指定します。Name は引数名で、Value は対応する値です。Name は一重引用符 (' ') で囲まなければなりません。Name1,Value1,...,NameN,ValueN のように、複数の名前と値のペアの引数を指定できます。

メモ

ここでは、プロパティの一部だけを紹介しています。完全な一覧については、Figure のプロパティ を参照してください。

Figure の名前。文字ベクトルまたは string スカラーとして指定します。

例: figure('Name','Results') は、Figure の名前を 'Results' に設定します。

既定の名前は 'Figure n' です。ここで、n は整数です。Name プロパティを指定した場合、Figure のタイトルは 'Figure n: name' になります。Name の値のみを表示する場合は、IntegerHandle または NumberTitle'off' に設定します。

背景色。RGB 3 成分、16 進数カラー コード、色名、または省略名として指定します。'none' を指定した場合、背景色は画面上では黒く表示されますが、Figure を印刷するとその背景は Figure ウィンドウが透明であるかのように印刷されます。

カスタム色を使用する場合は、RGB 3 成分または 16 進数カラー コードを指定します。

  • RGB 3 成分は、色の赤、緑、青成分の強度を指定する 3 成分の行ベクトルです。強度値は [0,1] の範囲でなければなりません。たとえば [0.4 0.6 0.7] のようになります。

  • 16 進数カラー コードは、ハッシュ記号 (#) で始まり、3 桁または 6 桁の 0 から F までの範囲の 16 進数が続く文字ベクトルまたは string スカラーです。これらの値では大文字小文字は区別されません。したがって、カラー コード '#FF8800''#ff8800''#F80'、および '#f80' は等価です。

あるいは、名前を使用して一部の一般的な色を指定できます。次の表に、名前の付いた色オプション、等価の RGB 3 成分、および 16 進数カラー コードを示します。

色名省略名RGB 3 成分16 進数カラー コード外観
'red''r'[1 0 0]'#FF0000'

'green''g'[0 1 0]'#00FF00'

'blue''b'[0 0 1]'#0000FF'

'cyan' 'c'[0 1 1]'#00FFFF'

'magenta''m'[1 0 1]'#FF00FF'

'yellow''y'[1 1 0]'#FFFF00'

'black''k'[0 0 0]'#000000'

'white''w'[1 1 1]'#FFFFFF'

'none'該当なし該当なし該当なし色なし

MATLAB の多くのタイプのプロットで使用されている既定の色の RGB 3 成分および 16 進数カラー コードを次に示します。

RGB 3 成分16 進数カラー コード外観
[0 0.4470 0.7410]'#0072BD'

[0.8500 0.3250 0.0980]'#D95319'

[0.9290 0.6940 0.1250]'#EDB120'

[0.4940 0.1840 0.5560]'#7E2F8E'

[0.4660 0.6740 0.1880]'#77AC30'

[0.3010 0.7450 0.9330]'#4DBEEE'

[0.6350 0.0780 0.1840]'#A2142F'

データ型: double | char

描画可能領域の位置とサイズ。[left bottom width height] の形式のベクトルとして指定します。この領域には、Figure の境界線、タイトル バー、メニュー バーおよびツール バーは含まれません。

次の表で、Position ベクトルの各要素について説明します。

要素説明
leftプライマリ ディスプレイの左端から、ウィンドウ内側の左端までの距離。この値は、複数のモニターがあるシステムでは負の値になる場合があります。

Figure がドッキングしている場合、この値は、MATLAB デスクトップ内の Figure パネルを基準にした値になります。
bottomプライマリ ディスプレイの下端から、ウィンドウ内側の下端までの距離。この値は、複数のモニターがあるシステムでは負の値になる場合があります。

Figure がドッキングしている場合、この値は、MATLAB デスクトップ内の Figure パネルを基準にした値になります。
widthfigure の内側の左右の端の間の距離です。
heightウィンドウ内側の上下の端の距離。

すべての測定値は、Units プロパティで指定した単位で表されます。

Figure がドッキングしているときには、Figure の Position プロパティは指定できません。

MATLAB Online™ では、Position ベクトルの bottom 要素および left 要素は無視されます。

境界線、タイトル バー、メニュー バーおよびツール バーを含むウィンドウ全体を配置するには、OuterPosition プロパティを使用します。

メモ

Windows® オペレーティング システムでは、最小ウィンドウ幅と最大ウィンドウ サイズが適用されます。これらの範囲を超える Figure サイズを指定した場合、表示される Figure は指定されたサイズではなく、これらの範囲に従います。

測定の単位。次の表のいずれかの値として指定します。

単位の値説明
'pixels' (既定)

ピクセル。

R2015b 以降、Windows および Macintosh システムにおいて、ピクセル単位の距離はシステム解像度に依存しません。

  • Windows システムの 1 ピクセルは 1/96 インチです。

  • Macintosh システムの 1 ピクセルは 1/72 インチです。

Linux® システムでは、ピクセルのサイズは使用しているシステムの解像度によって決まります。

'normalized'これらの単位は親コンテナーを基準として正規化されます。コンテナーの左下隅が (0,0) で、右上隅が (1,1) になります。
'inches'インチ。
'centimeters'センチメートル。
'points'ポイント。1 ポイントは 1/72 インチです。
'characters'

これらの単位は、グラフィックス ルート オブジェクトの既定の uicontrol フォントを基にしています。

  • 文字の幅 = 文字 x の幅。

  • 文字の高さ = 2 行のテキストのベースライン間の距離。

既定の uicontrol フォントにアクセスするには、get(groot,'defaultuicontrolFontName') または set(groot,'defaultuicontrolFontName') を使用します。

MATLAB ではすべての単位を親オブジェクトの左下隅から測定します。

このプロパティは Position プロパティに影響します。Units プロパティを変更した場合、この既定値を想定する他の関数に影響を与えないように、計算の完了後に値を既定値に戻すことを検討してください。

Units プロパティと Position プロパティを指定する順序は次のように影響します。

  • Position プロパティの前に Units プロパティを指定する場合、MATLAB は指定した単位を使用して Position を設定します。

  • Position プロパティの後に Units プロパティを指定する場合、MATLAB は既定の Units を使用して位置を設定します。その後、MATLAB は Position の値を、指定した単位における等価の値に変換します。

詳細

すべて折りたたむ

現在の Figure

現在の Figure は、axescolormap などのグラフィックス コマンドのターゲットです。通常、これは最後に作成された Figure、または最後にマウスでクリックされた Figure となります。gcf コマンドは、現在の Figure を返します。

参考

関数

プロパティ

R2006a より前に導入