align
UIControl
コンポーネントと Axes
オブジェクトの配置
構文
説明
メモ
関数 align
は、App Designer 内または関数 uifigure
を使用して作成されたアプリ内ではサポートされません。アプリ内でのコンポーネントの配置には、代わりにグリッド レイアウト マネージャーを使用してください。詳細については、代替機能を参照してください。
列内のオブジェクトを揃える
align(
は列内の指定されたコンポーネントを揃えます。この関数は、components
,hloc
,spacing
)hloc
の値に従ってオブジェクトの左側、中央、右側を揃え、spacing
の値に従ってオブジェクトの垂直方向の間隔を調整します。たとえば、align(components,"left","none")
は左端を揃えますが、間隔は調整しません。各オブジェクトのサイズは変わりません。
align(
は、垂直方向の間隔をポイント単位の一定の距離に調整します。components
,hloc
,"fixed"
,distance
)
行内のオブジェクトを揃える
align(
は行内の指定されたコンポーネントを揃えます。この関数は、components
,spacing
,vloc
)vloc
の値に従ってオブジェクトの上側、中央、下側を揃え、spacing
の値に従ってオブジェクトの水平方向の間隔を調整します。たとえば、align(components,"none","top")
は上端を揃えますが、間隔は調整しません。各オブジェクトのサイズは変わりません。
align(
は、水平方向の間隔をポイント単位の一定の距離に調整します。components
,"fixed"
,distance
,vloc
)
オーバーラップするオブジェクトを揃える
align(
は指定された互いにオーバーラップするオブジェクトを揃えます。これは、components
,hloc
,vloc
)hloc
に従って列内のオブジェクトを揃え、vloc
に従って行内のオブジェクトを揃えることと等価です。たとえば、align(components,"left","top")
は components
にあるオブジェクトの左上隅を揃えます。
計算した位置を返す
positions = align(___)
は、指定されたオブジェクトを揃えたときの位置を計算して行列として返しますが、オブジェクトは移動させません。行列出力の各行は位置ベクトルです。このオプションは、前述の構文のすべての入力引数の組み合わせで使用できます。
positions = align(
は、cpositions
,___)cpositions
に含まれるオブジェクトを揃えたときの位置を計算して返します。Figure のオブジェクトの位置は変わりません。このオプションは、前述の構文における任意の入力の組み合わせで、components
を cpositions
に置き換えて使用します。
例
入力引数
代替機能
App Designer 内および関数 uifigure
を使用して作成されたアプリ内では、グリッド レイアウト マネージャーを使用してコンポーネントを配置します。グリッド レイアウト マネージャーを使用して、グリッド内で UI コンポーネントをレイアウトできます。グリッド レイアウト マネージャーを作成するには、関数 uigridlayout
を呼び出すか、App Designer で [グリッド レイアウト] コンポーネントをキャンバスにドラッグします。
たとえば、列内の 3 つのボタンを Figure の左上隅に揃えて配置するには、4 つの行と 2 つの列を含むグリッド レイアウト マネージャーを作成します。最初の列と最初の 3 行を格納対象のコンポーネントに合わせてスケーリングするように指定します。次に、3 つのボタンを作成し、それらを最初の列の最初の 3 行に追加します。
fig = uifigure; fig.Position = [100 100 200 200]; gl = uigridlayout(fig); gl.RowHeight = {'fit','fit','fit','1x'}; gl.ColumnWidth = {'fit','1x'}; btn1 = uibutton(gl); btn1.Layout.Row = 1; btn1.Layout.Column = 1; btn2 = uibutton(gl); btn2.Layout.Row = 2; btn2.Layout.Column = 1; btn3 = uibutton(gl); btn3.Layout.Row = 3; btn3.Layout.Column = 1;
あるいは、App Designer で、[キャンバス] タブの [スペース] オプションを使用して [設計ビュー] でコンポーネントを配置します。詳細については、App Designer の設計ビューでのアプリのレイアウトを参照してください。
バージョン履歴
R2012b で導入