BubbleLegend のプロパティ
バブル凡例の外観と動作
BubbleLegend プロパティは、BubbleLegend オブジェクトの外観と動作を制御します。プロパティの値を変更することによって、凡例の特定の要素を変更できます。プロパティのクエリと設定にはドット表記を使用します。
blgd = bubblelegend; blgd.Style = 'telescopic';
位置とレイアウト
座標軸に対する相対的な位置。次の表に挙げる位置の値のいずれかとして指定します。
| 値 | 説明 |
|---|---|
'north' | 座標軸内の上端。 |
'south' | 座標軸内の下端。 |
'east' | 座標軸内の右端。 |
'west' | 座標軸内の左端。 |
'northeast' | 座標軸内の右上隅。 |
'northwest' | 座標軸内の左上隅。 |
'southeast' | 座標軸内の右下隅。 |
'southwest' | 座標軸内の左下隅。 |
'northoutside' | 座標軸の上部。 |
'southoutside' | 座標軸の下部。 |
'eastoutside' | 座標軸の右側。 |
'westoutside' | 座標軸の左側。 |
'northeastoutside' | 座標軸外の右上隅。 |
'northwestoutside' | 座標軸外の左上隅。 |
'southeastoutside' | 座標軸外の右下隅。 |
'southwestoutside' | 座標軸外の左下隅 |
'layout' | タイル表示チャート レイアウト内のタイル。凡例を別のタイルに移動するには、Layout プロパティを設定します。 |
'none' | Position プロパティで決定した位置。Position プロパティを使用してカスタムの位置を指定します。 |
カスタムの位置とサイズ。[left bottom width height] の形式の 4 要素ベクトルとして指定します。最初の 2 つの値 left と bottom は、Figure の左下隅から凡例の左下隅までの距離を指定します。最後の 2 つの値 width と height は、凡例のサイズを指定します。位置の単位は Units プロパティで定義されます。
Position プロパティを設定すると、MATLAB® は Location プロパティを自動的に 'none' に変更します。
例: bubblelegend('Position',[0.2 0.6 0.1 0.2])
メモ
親コンテナーが TiledChartLayout オブジェクトの場合、このプロパティを設定しても効果はありません。
位置の単位。次の表のいずれかの値を指定します。
Units | 説明 |
|---|---|
'normalized' (既定) | コンテナー (通常は Figure) を基準に正規化されます。Figure の左下隅が (0,0) で、右上隅が (1,1) になります。Figure のサイズを変更すると、Position ベクトルの値が更新されます。 |
'inches' | インチ。 |
'centimeters' | センチメートル。 |
'characters' | 既定のシステム フォントの文字サイズを基準にします。
|
'points' | ポイント。1 ポイントは 1/72 インチです。 |
'pixels' | ピクセル。 Windows® システムおよび Macintosh システムでは、ピクセルのサイズは 1/96 インチです。このサイズはシステムの解像度に依存しません。 Linux® システムでは、ピクセルのサイズは使用しているシステムの解像度によって決まります。 |
すべての単位は、コンテナー ウィンドウの左下隅から測定されます。
このプロパティは Position プロパティに影響します。単位を変更した場合、Units が既定値であることを前提としている他の関数に影響を及ぼさないように、計算終了後に元の既定値に戻すことを推奨します。
オブジェクトの作成時に Position プロパティと Units プロパティを Name,Value のペアとして指定する場合は、指定する順序が重要です。特定の単位で位置を定義するには、Units プロパティを設定してから Position プロパティを設定しなければなりません。
レイアウト オプション。TiledChartLayoutOptions オブジェクトとして指定します。このプロパティは、凡例がタイル表示チャート レイアウトにある場合に役立ちます。
タイル表示チャート レイアウトのグリッド内に凡例を配置するには、Tile プロパティを TiledChartLayoutOptions オブジェクトに設定します。たとえば、3 行 3 列のタイル表示チャート レイアウトについて考えます。レイアウトの中央にタイルのグリッドがあり、外側のエッジに沿って 4 つのタイルがあります。実際には、グリッドは非表示であり、座標軸またはその他のオブジェクトが入力されるまで、外側のタイルは領域を占有しません。
次のコードは、凡例 lgd をグリッドの 3 番目のタイルに配置します。
lgd.Layout.Tile = 3;
凡例を周囲のいずれかのタイルに配置するには、Tile プロパティを 'north'、'south'、'east'、または 'west' として指定します。たとえば、値を 'east' に設定すると、タイル内の凡例はグリッドの右側のタイルに配置されます。
lgd.Layout.Tile = 'east';凡例がタイル表示チャート レイアウトの子ではない場合 (たとえば、Figure の子である場合)、このプロパティは空で、効果はありません。
ラベル
凡例のタイトル。legend text オブジェクトとして返されます。凡例のタイトルを追加するには、legend text オブジェクトの String プロパティを設定します。フォント スタイルや色など、タイトルの外観を変更するには、凡例のテキスト プロパティを設定します。一覧については、Text のプロパティ を参照してください。
blgd = bubblelegend;
blgd.Title.String = 'My Legend Title';
blgd.Title.FontSize = 12;あるいは、関数 bubblelegend を呼び出して、タイトルを最初の引数として指定します。また、関数 title を使用してタイトルの要素を作成または変更できます。
blgd = bubblelegend('My Legend Title'); title(blgd,'A Different Title','FontSize',12)
範囲ラベル。文字ベクトルの 2 要素または 3 要素の cell 配列または string 配列として指定します。凡例内の最小のバブルの横に最初のラベルが表示され、最大のバブルの横に最後のラベルが表示されます。3 つのラベルを指定すると、凡例が水平の場合または凡例に 2 つのバブルしか含まれない場合、2 つ目のラベルは表示されません。次の表に、いくつかの共通シナリオを示します。
| 例 | 結果 |
|---|---|
3 つのバブルを使用する垂直の凡例を作成し、3 つの範囲ラベルを指定します。 blgd = bubblelegend;
blgd.LimitLabels = {'Shortage','Abundance','Surplus'}; |
|
3 つのバブルを使用する telescopic 凡例を作成し、3 つの範囲ラベルを指定します。 blgd = bubblelegend('Style','telescopic'); blgd.LimitLabels = {'Shortage','Abundance','Surplus'}; |
|
2 つのバブルを使用する垂直の凡例を作成し、3 つの範囲ラベルを指定します。 blgd = bubblelegend('NumBubbles',2); blgd.LimitLabels = {'Shortage','Abundance','Surplus'}; |
|
3 つのバブルを使用する水平の凡例を作成し、3 つの範囲ラベルを指定します。 blgd = bubblelegend('Style','horizontal'); blgd.LimitLabels = {'Shortage','Abundance','Surplus'}; |
|
LaTeX マークアップ
LaTeX マークアップを使用するには、インタープリターを "latex" に設定します。インライン モードでは、マークアップを 1 つのドル記号 ($) で囲みます。表示モードでは、マークアップを 2 つのドル記号 ($$) で囲みます。
| LaTeX モード | 例 | 結果 |
|---|---|---|
| インライン |
"$\int_1^{20} x^2 dx$" |
|
| 表示 |
"$$\int_1^{20} x^2 dx$$" |
|
テキストは LaTeX の既定のフォント スタイルで表示され、FontName、FontWeight、FontAngle のプロパティは無視されます。フォント スタイルを変更するには、LaTeX マークアップを使用します。
LaTeX インタープリターで使用できるテキストの最大サイズは 1200 文字です。複数行のテキストの場合は、さらに 1 行につき 10 文字ほど文字数が少なくなります。
MATLAB では、大半の標準の LaTeX 数式モード コマンドがサポートされています。詳細については、サポートされる LaTeX コマンドを参照してください。TeX および LaTeX の使用例については、チャートのテキスト内のギリシャ文字と特殊文字を参照してください。
フォント
色とスタイル
凡例のスタイル。表のいずれかの値として指定します。表内のイメージは、スタイルが異なる 3 つのバブルを使用した凡例を示しています。
| Style の値 | 外観 |
|---|---|
'vertical' |
|
'horizontal' |
|
'telescopic' |
|
凡例に表示されるバブルの数。2 または 3 として指定します。以下の表は、2 つおよび 3 つのバブルを使用した垂直のバブル凡例を示しています。
| NumBubbles 値 | 外観 |
|---|---|
2 |
|
3 |
|
バブル サイズの順序。以下の表のいずれかの値として指定します。以下の表に、3 つのバブルを含む垂直の凡例に異なる値を指定した結果を示します。
| BubbleSizeOrder 値 | 外観 |
|---|---|
'descending' |
|
'ascending' |
|
あるいは、名前を使用して一部の一般的な色を指定できます。次の表に、名前の付いた色オプション、等価の 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" | 該当なし | 該当なし | 該当なし | 色なし |
次の表に、ライト テーマとダーク テーマでのプロットの既定のカラー パレットを示します。
| パレット | パレットの色 |
|---|---|
R2025a より前: ほとんどのプロットで、これらの色が既定で使用されます。 |
|
|
|
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 進数カラー コードを取得します。
例: [0 0 1]
例: 'blue'
例: '#0000FF'
背景色。RGB 3 成分、16 進数カラー コード、色名、または省略名として指定します。既定値の [1 1 1] は、白に相当します。
カスタム色を使用する場合は、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" | 該当なし | 該当なし | 該当なし | 色なし |
次の表に、ライト テーマとダーク テーマでのプロットの既定のカラー パレットを示します。
| パレット | パレットの色 |
|---|---|
R2025a より前: ほとんどのプロットで、これらの色が既定で使用されます。 |
|
|
|
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 進数カラー コードを取得します。
例: bubblelegend('Color','y')
例: bubblelegend('Color',[0.8 0.8 1])
例: bubblelegend('Color','#D9A2E9')
ボックス外枠の色。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" |
|
"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" | 該当なし | 該当なし | 該当なし | 色なし |
次の表に、ライト テーマとダーク テーマでのプロットの既定のカラー パレットを示します。
| パレット | パレットの色 |
|---|---|
R2025a より前: ほとんどのプロットで、これらの色が既定で使用されます。 |
|
|
|
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 進数カラー コードを取得します。
例: bubblelegend('EdgeColor',[0 1 0])
ボックスの外枠の表示。'on' または 'off'、もしくは数値または logical 1 (true) または 0 (false) として指定します。'on' の値は true と等価であり、'off' の値は false と等価です。したがって、このプロパティの値を logical 値として使用できます。値は、matlab.lang.OnOffSwitchState 型の on/off の logical 値として保存されます。
'on'— 凡例の周囲にボックスを表示します。'off'— 凡例の周囲にボックスを表示しません。
対話機能
コールバック
コールバック実行制御
親/子
識別子
バージョン履歴
R2020b で導入
