uiaxes
アプリでのプロット用の UI 座標軸の作成
説明
ax = uiaxesUIAxes オブジェクトを返します。MATLAB® は関数 uifigure を呼び出してこの Figure を作成します。
UIAxes オブジェクトは、アプリで直交プロットを作成するのに便利です。これらは、関数 axes で返される直交 Axes オブジェクトとよく似ています。そのため、Axes オブジェクトを受け取るほとんどの関数に UIAxes オブジェクトを渡すことができます。詳細については、UIAxes オブジェクトと Axes オブジェクトの差異を参照してください。
ax = uiaxes(Name,Value)Name,Value のペアの引数を使用して、UIAxes のプロパティ値を指定します。
ax = uiaxes(parent,Name,Value)Name,Value の引数を使用して、UIAxes のプロパティ値を指定します。
例
UI 座標軸にライン プロットと散布図を作成します。
UI 座標軸をもつ Figure ウィンドウを作成し、UIAxes オブジェクトを変数 ax に割り当てます。UIAxes オブジェクトを関数 plot の最初の入力引数として指定して、ライン プロットを座標軸に追加します。
fig = uifigure; ax = uiaxes(fig); x = linspace(-pi,pi,50); y = 5*sin(x); plot(ax,x,y)
ホールド状態をオンに設定し、散布図を追加します。UIAxes オブジェクトを関数 hold および関数 scatter の最初の入力引数として指定します。
hold(ax,'on')
y2 = 5*sin(x) + randn(1,50);
scatter(ax,x,y2)
名前と値のペアの引数を使用してプロパティを設定することにより、UI 座標軸の外観を変更します。たとえば、XDir の名前と値のペアを使用して、x 軸の方向を反転します。
fig = uifigure; ax = uiaxes(fig,'XDir','reverse'); x = linspace(-pi,pi); y = sin(x); plot(ax,x,y)
あるいは、座標軸の作成後にドット表記を使用してプロパティを指定します。たとえば、ドット表記を使用して YDir プロパティにアクセスし、y 軸の方向を反転します。
ax.YDir = 'reverse';Position プロパティを指定して、UI 座標軸の位置を指定します。位置をピクセル単位で指定します。
fig = uifigure;
ax = uiaxes(fig,'Position',[10 10 550 400]);
UI 座標軸を、Figure ウィンドウ内のパネルに追加します。パネルと座標軸の位置をピクセル単位で指定します。
fig = uifigure; p = uipanel(fig,'Position',[10 10 400 400]); ax = uiaxes(p,'Position',[10 10 370 370]);
入力引数
名前と値の引数
オプションの引数のペアを Name1=Value1,...,NameN=ValueN として指定します。ここで、Name は引数名で、Value は対応する値です。名前と値の引数は他の引数の後に指定しなければなりませんが、ペアの順序は重要ではありません。
R2021a より前では、コンマを使用して名前と値をそれぞれ区切り、Name を引用符で囲みます。
例: 'Xscale','linear','YScale','log'
ここでは、プロパティの一部だけを紹介しています。完全な一覧については、UIAxes のプロパティ を参照してください。
軸のスケール。次の値のいずれかとして指定します。
| 値 | 説明 | 結果 |
|---|---|---|
'linear' | 線形スケール 例: |  |
'log' | 対数スケール 例: メモ 座標軸では、場合によっては座標を除外することがあります。
|  |
グリッド ラインのライン スタイル。次の表のライン スタイルのいずれかとして指定します。
| ライン スタイル | 説明 | 結果として得られる線 |
|---|---|---|
"-" | 実線 |
|
"--" | 破線 |
|
":" | 点線 |
|
"-." | 一点鎖線 |
|
"none" | ラインなし | ラインなし |
グリッド ラインを表示するには、grid on コマンドを使用するか、XGrid、YGrid、ZGrid の各プロパティを 'on' に設定します。
例: ax.GridLineStyle = '--'
ラベルと余白を含む座標軸のサイズと位置。[left bottom width height] の形式の 4 要素ベクトルとして指定します。このプロパティは、OuterPosition プロパティと等価です。ベクトルは、座標軸の外側の境界を囲む四角形を定義します。値は、Units プロパティで指定した単位で測定されます。既定値はピクセルです。
left要素およびbottom要素は、親コンテナーの左下隅からの測定値により、四角形の位置を定義します。widthおよびheightは、四角形のサイズを定義します。
座標軸の周りのテキストを考慮して位置を指定する場合は、Position プロパティまたは OuterPosition プロパティを設定します。これらの Figure は Position (または OuterPosition) で定義された領域を青色で、InnerPosition を赤色で表示します。
| 座標軸の 2 次元表示 | 座標軸の 3 次元表示 |
|---|---|
|
|
メモ
親コンテナーが TiledChartLayout オブジェクトの場合、このプロパティを設定しても効果はありません。
出力引数
詳細
バージョン履歴
R2016a で導入
