uipanel

パネル コンテナーの作成

ページ内をすべて折りたたむ

構文

p = uipanel
p = uipanel(parent)
p = uipanel(___,Name,Value)

説明

p = uipanel は現在の Figure 内にパネルを作成し、Panel オブジェクトを返します。利用可能な Figure がない場合は、MATLAB® が関数 figure を呼び出して Figure を作成します。

p = uipanel(parent) は、指定された親コンテナー内にパネルを作成します。親コンテナーには、Figure か、Figure の子コンテナーを指定できます。

例

p = uipanel(___,Name,Value) は、1 つ以上の名前と値の引数を使用して、パネル プロパティを指定します。このオプションは、前述の構文のすべての入力引数の組み合わせで使用できます。

例

例

すべて折りたたむ

ライブ スクリプトを開く

UI Figure 内にパネルを作成します。

fig = uifigure;
p = uipanel(fig);

Figure contains an object of type uipanel.

ライブ スクリプトを開く

UI Figure 内にパネルを作成し、ボタンをパネルに追加します。

fig = uifigure;
p = uipanel(fig);
btn = uibutton(p);

Figure contains an object of type uipanel.

ライブ スクリプトを開く

UI Figure 内にパネルを作成し、プロパティ値を指定してその外観をカスタマイズします。

fig = uifigure;
p = uipanel(fig, ...
    "Title","Data", ...
    "BackgroundColor","white");

Figure contains an object of type uipanel.

パネルの位置とサイズを決定します。

s = p.Position
s = 1×4

    20    20   260   221

パネルの Position プロパティの 3 番目と 4 番目の要素を変更して、パネルの幅および高さを更新します。

p.Position(3:4) = [150 380];

Figure contains an object of type uipanel.

UI Figure 内にパネルを作成します。6 つの UI コンポーネントをパネルに追加します。最初の 2 つのコンポーネントは、パネルの上縁から外れているため、表示されません。

fig = uifigure;
p = uipanel(fig,"Position",[20 20 196 135]);
ef1 = uieditfield(p,"Text","Position",[11 165 140 22],"Value","First Name");
ef2 = uieditfield(p,"Text","Position",[11 140 140 22],"Value","Last Name");
ef3 = uieditfield(p,"Text","Position",[11 115 140 22],"Value","Address");
dd = uidropdown(p,"Position",[11 90 140 22],"Items",["Male","Female"]);
cb = uicheckbox(p,"Position",[11 65 140 22],"Text","Member");
btn = uibutton(p,"Position",[11 40 140 22],"Text","Send");

UI figure window with a panel with four UI components. Only one edit field is visible.

Scrollable プロパティを "on" に設定して、パネルでスクロールを有効にします。既定では、スクロール バーはパネルの最上部にスクロールされています。

p.Scrollable = "on";

UI figure window with a scrollable panel. The panel has a scroll bar on its right. The bar is scrolled to the top, and all three edit fields are visible in the panel.

入力引数

すべて折りたたむ

親コンテナー。Figure オブジェクトまたはその子コンテナー (Tab、Panel、ButtonGroup、GridLayout) のいずれかとして指定します。

名前と値の引数

すべて折りたたむ

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

例: uipanel(Title="Options") は、パネルのタイトルを Options に指定します。

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

例: uipanel("Title","Options") は、パネルのタイトルを Options に指定します。

メモ

以下にリストするプロパティは、利用できるプロパティの一部です。完全なリストについては、Panel を参照してください。

タイトル。文字ベクトル、string スカラー、または categorical 配列として指定します。このプロパティを categorical 配列として指定した場合、MATLAB は配列の最初の要素のみを表示します。

MATLAB では垂直スラッシュ ('|') 文字は改行として解釈されず、タイトル内に垂直スラッシュとして表示されます。

Unicode® 文字を指定する場合、Unicode 10 進コードを関数 char に渡します。たとえば、['Multiples of ' char(960)] は Multiples of π として表示されます。

背景色。RGB 3 成分、16 進数カラー コード、または表にリストされた色オプションのいずれかとして指定します。

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"

Sample of the color red

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

Sample of the color green

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

Sample of the color blue

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

Sample of the color cyan

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

Sample of the color magenta

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

Sample of the color yellow

"black""k"[0 0 0]"#000000"

Sample of the color black

"white""w"[1 1 1]"#FFFFFF"

Sample of the color white

次の表に、ライト テーマとダーク テーマでのプロットの既定のカラー パレットを示します。

パレットパレットの色

"gem" — ライト テーマの既定値

R2025a より前: ほとんどのプロットで、これらの色が既定で使用されます。

Sample of the "gem" color palette

"glow" — ダーク テーマの既定値

Sample of the "glow" color palette

orderedcolors 関数と rgb2hex 関数を使用すると、これらのパレットの RGB 3 成分および 16 進数カラー コードを取得できます。たとえば、"gem" パレットの RGB 3 成分を取得し、16 進数カラー コードに変換します。

RGB = orderedcolors("gem");
H = rgb2hex(RGB);

R2023b より前: RGB = get(groot,"FactoryAxesColorOrder") を使用して、RGB 3 成分を取得します。

R2024a より前: H = compose("#%02X%02X%02X",round(RGB*255)) を使用して、16 進数カラー コードを取得します。

パネルの位置とサイズ。境界とタイトルを含みます。[left bottom width height] の形式の 4 要素ベクトルとして指定します。次の表で、ベクトルの各要素について説明します。

要素説明
left親コンテナーの内側左端からパネルの外側左端までの距離
bottom親コンテナーの内側下端からパネルの外側下端までの距離
widthパネルの外側の右端と左端の間の距離
heightパネルの外側の上端と下端の間の距離

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

Position の値の基準は、親コンテナーの "描画可能領域" です。描画可能領域は、コンテナーの境界線の内側にある領域で、メニュー バーやタイトルなどの装飾が占める領域は含まれません。

メモ

パネルがグリッド レイアウト マネージャーを親とする場合、Position プロパティの値は直ちには更新されません。Position の値を使用して、パネルのサイズを基準にパネルの子のサイズを変更するには、SizeChangedFcn コールバックを使用します。

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

単位の値説明
'pixels' (uifigure ベースのアプリの既定)

Windows® システムおよび Macintosh システムでは、ピクセルのサイズは 1/96 インチです。このサイズはシステムの解像度に依存しません。

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

'normalized' (figure ベースのアプリの既定)

これらの単位は親コンテナーを基準として正規化されます。コンテナーの左下隅が (0,0) で、右上隅が (1,1) になります。

'inches'インチ。
'centimeters'センチメートル。
'points'ポイント。1 ポイントは 1/72 インチです。
'characters'

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

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

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

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

MATLAB のほとんどのアプリ作成機能では距離をピクセル単位で測定するため、推奨値は 'pixels' です。親コンテナーのサイズに基づいて再スケーリングされるオブジェクトを作成するには、関数 uigridlayout を使用して作成されたグリッド レイアウト マネージャーをオブジェクトの親にします。詳細については、プログラミングによるアプリのレイアウトを参照してください。

ヒント

panel オブジェクトの Visible プロパティが "off" に設定されている場合、それに含まれる子オブジェクト (ボタン、ボタン グループ、座標軸など) は、親パネルと共に非表示になります。ただし、個々の子オブジェクトの Visible "プロパティ値" は影響を受けません。

バージョン履歴

R2006a より前に導入

すべて展開する

参考

プロパティ