目盛りの位置。単調増加する数値のベクトルとして指定します。値と値の間は等間隔にする必要はありません。目盛りを表示しない場合は,このプロパティを空のベクトル［］に設定します。

例:[1, 0, 1, 2, 3, 4, 5]

データ型:单|双

蜱虫の選択モード。次の値のいずれかとして指定します。

目盛りラベル。文字ベクトルの cell 配列、string 配列、数値配列、文字ベクトルまたは categorical 配列として指定します。既定では、カラー バーには目盛りと数値のラベルが付けられます。ラベルを指定する場合、指定したラベルの数が目盛りの数よりも少ないと、MATLAB^®ではそれらのラベルが繰り返し使用されます。

このプロパティを直言配列として指定した場合,MATLABはカテゴリではなく,配列内の値を使用します。

例:{“冷”、“热”、“热”}

TickLabelsの選択モード。次の値のいずれかとして指定します。

目盛りラベルインタープリター。次の値のいずれかとして指定します。

特克斯マークアップ

MATLABでは,既定で特克斯マークアップのサブセットをサポートしています。特克斯マークアップを使用して、上付き文字や下付き文字の追加、テキストのタイプや色の変更、ラベルへの特殊文字の挿入を行うことができます。

修飾子の効果はテキストの末尾まで適用されます。上付き文字と下付き文字は例外であり、次の 1 文字または中かっこで囲まれた文字にのみ適用されます。インタープリターを“泰克斯”に設定した場合にサポートされる修飾子は次のとおりです。

次の表に,“泰克斯”インタープリターでサポートされる特殊文字を示します。

乳胶マークアップ

乳胶マークアップを使用するには,TickLabelInterpreterプロパティを“乳胶”に設定します。ラベルをドル記号で囲みます。たとえば、インライン モードでは“美元\ int_1 ^ {20} x ^ 2 dx $ ',表示モードでは' $ $ \ int_1 ^ {20} x ^ 2 dx $ $”を使用します。

テキストは乳胶の既定のフォントスタイルで表示され,字体名、FontWeight、FontAngleのプロパティは無視されます。フォントスタイルを変更するには、テキスト内で LaTeX マークアップを使用します。LaTeX インタープリターで使用できるテキストの最大サイズは 1200 文字です。複数行のテキストの場合、テキストの最大サイズは 1 行につき 10 文字ほど文字数が少なくなります。

特克斯および乳胶の使用例については,チャートのテキスト内のギリシャ文字と特殊文字を参照してください。乳胶システムの詳細については,乳胶プロジェクトのWebサイト(https://www.latex-project.org/)を参照してください。

目盛りの最大値と最小値。2要素ベクトルとして指定します。2番目の要素は最初の要素よりも大きくなければなりません。

例:[0 1]

データ型:单|双|int8|int16|int32|int64|uint8|uint16|uint32|uint64

範囲の選択モード。次の値のいずれかとして指定します。

カラーバーと共に表示されるラベル。文本オブジェクトとして返されます。この文本オブジェクトには,ラベルの外観および表示するテキストを制御するプロパティがあります。文本オブジェクトにアクセスするには,标签プロパティを使用します。次に例を示します。

c = colorbar;c.Label

ans = Text with properties: String: " FontSize: 10 FontWeight: 'normal' FontName: 'Helvetica' Color: [0.1500 0.1500 0.1500] HorizontalAlignment: 'left' Position: [0 00] Units: 'data'显示所有属性

ラベルの追加または変更を行うには,文本オブジェクトの字符串プロパティを,たとえば次のように設定します。

c.Label.String =" Label Text Goes Here "；

フォントスタイルや色などのラベルの外観を変更するには,他のテキストプロパティを設定します。たとえば,次のコードはフォントサイズを変更します。

c.Label.FontSize = 12;

オプションの完全な一覧については,文本のプロパティを参照してください。

カラースケールの向き。次の値のいずれかとして指定します。

目盛りの長さ。スカラーとして指定します。目盛りの長さをカラー バーの軸の長さに対する割合として指定します。

例:0．05

データ型:单|双|int8|int16|int32|int64|uint8|uint16|uint32|uint64

目盛りの方向。次の値のいずれかとして指定します。

フォント名。サポートされているフォント名または“FixedWidth”として指定します。テキストを正しく表示し印刷するには,システムでサポートされているフォントを選択しなければなりません。既定のフォントは,オペレーティングシステムとロケールによって異なります。

どのロケールでもテキストが整って見える固定幅のフォントを使用するには,“FixedWidth”を使用します。固定幅フォントは,ルートのFixedWidthFontNameプロパティによって決まります。ルートのFixedWidthFontNameプロパティを設定すると,表示内容が新しいフォントを使用して直ちに更新されます。

フォントサイズ。ポイント単位のゼロより大きいスカラー値として指定します。既定のフォントサイズは,特定のオペレーティングシステムとロケールによって異なります。

座標軸のフォントサイズを変更すると,カラーバーのフォントサイズはMATLABによって自動的に座標軸のフォントサイズの90%に設定されます。カラーバーのフォントサイズを手動で設定した場合は,座標軸のフォントサイズを変更してもカラーバーのフォントは影響を受けません。

文字の傾斜。“正常”または“斜体”として指定します。

すべてのフォントに両方のフォントスタイルがあるとは限りません。そのため,イタリックフォントを指定しても標準フォントと変わらない場合があります。

文字の太さ。“正常”または“大胆”として指定します。

MATLABではフォントは,FontWeightプロパティを使用して,ユーザーのシステムで使用可能なフォントから選択します。すべてのフォントに太字があるとは限りません。そのため,太字フォントを指定しても標準フォントの太さと変わらない場合があります。

座標軸を基準にした位置。次の表にリストされた値のいずれかとして指定します。

この表の位置以外にカラーバーを表示するには,位置プロパティを使用してカスタムの位置を指定します。位置プロパティを設定すると,MATLABで位置プロパティが“手动”に設定されます。位置プロパティが“手动”に設定されている場合,関連付けられている座標軸のサイズはカラーバーに合わせて変更されません。

軸の位置。次の値のいずれかとして指定します。このプロパティを使用して,目盛り,目盛りラベルおよびカラーバーラベルの位置を指定します。

AxisLocationの選択モード。次の値のいずれかとして指定します。

カスタムの位置とサイズ。[左，下，宽，高]の形式の4要素ベクトルとして指定します。左要素と底要素で,图の左下隅からカラーバーの左下隅までの距離を指定します。宽度要素と高度要素で,カラーバーの大きさを指定します。位置の単位は单位プロパティで定義されます。

位置プロパティを指定すると,MATLABによって位置プロパティが“手动”に変更されます。位置プロパティが“手动”の場合,関連付けられている座標軸のサイズはカラーバーに合わせて変更されません。

例:[0.1 0.1 0.3 0.7]

位置の単位。次の表のいずれかの値を指定します。

すべての単位は,親コンテナーの左下隅から測定されます。

このプロパティは,位置プロパティなどの他のプロパティに影響を与えます。単位を変更した場合,既定値を前提としている他の関数に影響を及ぼさないように,計算終了後に単位を元の既定値に戻してください。

オブジェクトの作成時に位置プロパティと单位プロパティを名称,值のペアとして指定する場合は,指定する順序が重要です。たとえば,特定の単位で位置を設定するには,位置プロパティの前に单位プロパティを設定しなければなりません。

レイアウトオプション。TiledChartLayoutOptionsオブジェクトとして指定します。このプロパティはカラーバーがタイル表示チャートレイアウトにある場合に役立ちます。

タイル表示チャートレイアウトのグリッド内にカラーバーを配置するには,瓷砖プロパティをTiledChartLayoutOptionsオブジェクトに設定します。たとえば、3 行 3 列のタイル表示チャート レイアウトについて考えます。レイアウトの中央にタイルのグリッドがあり、外側のエッジに沿って 4 つのタイルがあります。実際には、グリッドは非表示であり、座標軸またはその他のオブジェクトが入力されるまで、外側のタイルは領域を占有しません。

次のコードはカラーバーcbをグリッドの3番目のタイルに配置します。

cb.Layout.Tile = 3;

カラーバーを周囲のいずれかのタイルに配置するには,瓷砖プロパティを“北”、“南”、“东”,または“西方”として指定します。たとえば,値を“东”に設定すると,タイル内のカラーバーはグリッドの右側のタイルに配置されます。

cb.Layout.Tile =“东”；

カラーバーがタイル表示チャートレイアウトの子ではない場合(たとえば,图の子である場合),このプロパティは空で,効果はありません。

目盛り,テキスト,およびボックスの外枠の色。RGB 3成分、16 進数カラー コード、色名、または省略名として指定します。

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

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

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

例:(0 1 0)

例:“绿色”

例:“# 00 ff00”

ボックスの外枠。“上”または“关闭”,もしくは数値または逻辑1(真正的)または0(假)として指定します。“上”の値は真正的と等価であり,“关闭”は假と等価です。したがって,このプロパティの値を逻辑値として使用できます。値はmatlab.lang.OnOffSwitchState型の开/关逻辑値として格納されます。

ボックスの外枠の幅。ポイント単位の正の値として指定します。1ポイントは1/72インチです。

例:1．5

可視性の状態。“上”または“关闭”,もしくは数値または逻辑1(真正的)または0(假)として指定します。“上”の値は真正的と等価であり,“关闭”は假と等価です。したがって,このプロパティの値を逻辑値として使用できます。値はmatlab.lang.OnOffSwitchState型の开/关逻辑値として格納されます。

コンテキストメニュー。快捷菜单オブジェクトとして指定します。このプロパティは,オブジェクトを右クリックしたときにコンテキスト メニューを表示するために使用します。関数uicontextmenuを使用して,コンテキストメニューを作成します。

選択状態。“上”または“关闭”,もしくは数値または逻辑1(真正的)または0(假)として指定します。“上”の値は真正と等価であり,“关闭”は假と等価です。したがって,このプロパティの値を逻辑値として使用できます。値はmatlab.lang.OnOffSwitchState型の开/关逻辑値として格納されます。

選択時の選択ハンドルの表示。“上”または“关闭”,もしくは数値または逻辑1(真正的)または0(假)として指定します。“上”の値は真正と等価であり,“关闭”は假と等価です。したがって,このプロパティの値を逻辑値として使用できます。値はmatlab.lang.OnOffSwitchState型の开/关逻辑値として格納されます。

マウスクリックコールバック。次の値のいずれかとして指定します。

このプロパティは,オブジェクトをクリックしたときにコードを実行するために使用します。関数ハンドルを使用してこのプロパティを指定した場合、MATLAB はコールバックを実行するときに次の 2 つの引数をコールバック関数に渡します。

関数ハンドルを使用してコールバック関数を定義する方法についての詳細は,コールバック定義を参照してください。

オブジェクト作成関数。次の値のいずれかとして指定します。

コールバックを関数ハンドル,细胞配列,または文字ベクトルとして指定する方法の詳細については,コールバック定義を参照してください。

このプロパティは,MATLABがオブジェクトを作成するときに実行されるコールバック関数を指定します。MATLABはCreateFcnコールバックを実行する前に,すべてのプロパティ値を初期化します。CreateFcnプロパティを指定しない場合,MATLABは既定の作成関数を実行します。

既存のコンポーネントにCreateFcnプロパティを設定しても効果はありません。

このプロパティを関数ハンドルまたは细胞配列として指定した場合,コールバック関数の最初の引数を使用して,作成中のオブジェクトにアクセスできます。それ以外の場合は,関数gcboを使用してオブジェクトにアクセスします。

オブジェクト削除関数。次の値のいずれかとして指定します。

コールバックを関数ハンドル,细胞配列,または文字ベクトルとして指定する方法の詳細については,コールバック定義を参照してください。

このプロパティは,MATLABがオブジェクトを削除するときに実行されるコールバック関数を指定します。MATLABは,オブジェクトのプロパティを破棄する前にDeleteFcnコールバックを実行します。DeleteFcnプロパティを指定しない場合,MATLABは既定の削除関数を実行します。

このプロパティを関数ハンドルまたは细胞配列として指定した場合,コールバック関数の最初の引数を使用して,削除されるオブジェクトにアクセスできます。それ以外の場合は,関数gcboを使用してオブジェクトにアクセスします。

コールバックの割り込み。“上”または“关闭”,もしくは数値または逻辑1(真正的)または0(假)として指定します。“上”の値は真正と等価であり,“关闭”は假と等価です。したがって,このプロパティの値を逻辑値として使用できます。値はmatlab.lang.OnOffSwitchState型の开/关逻辑値として格納されます。

このプロパティは実行中のコールバックが割り込み可能かどうかを決定します。2次のつのコールバックの状態について考慮する必要があります。

MATLABがコールバックを呼び出すたびに,そのコールバックは実行中のコールバックに割り込もうとします。実行中のコールバックを所有するオブジェクトの可中断プロパティが,割り込みを許可するかどうかを決定します。可中断プロパティは次の2つの値をとることができます。

コールバックキューイング。“队列”または“取消”として指定します。BusyActionプロパティはMATLABによる割り込みコールバックの実行の処理方法を決定します。2次のつのコールバックの状態について考慮する必要があります。

MATLABがコールバックを呼び出すたびに,そのコールバックは実行中のコールバックに割り込もうとします。実行中のコールバックを所有するオブジェクトの可中断プロパティが,割り込みを許可するかどうかを決定します。割り込みが許可されない場合は,割り込みコールバックを所有するオブジェクトのBusyActionプロパティが,そのコールバックを破棄するかキューに入れるかを決定します。BusyActionプロパティは次の値を取ることができます。

マウスクリックキャプチャ機能。第1次の値のつとして指定します。

キャプチャしたマウスクリックへの応答。“上”または“关闭”,もしくは数値または逻辑1(真正的)または0(假)として指定します。“上”の値は真正と等価であり,“关闭”は假と等価です。したがって,このプロパティの値を逻辑値として使用できます。値はmatlab.lang.OnOffSwitchState型の开/关逻辑値として格納されます。

このプロパティは読み取り専用です。

削除状態。matlab.lang.OnOffSwitchState型の开/关逻辑値として返されます。

MATLABは,DeleteFcnコールバックが実行を開始すると,BeingDeletedプロパティを“上”に設定します。コンポーネントオブジェクトが存在しなくなるまでBeingDeletedプロパティは“上”に設定されたままです。

クエリや変更の前にオブジェクトが削除されようとしていないか確認するためにBeingDeletedプロパティの値をチェックします。

親コンテナー。数字オブジェクト,面板オブジェクト,选项卡オブジェクト,またはTiledChartLayoutオブジェクトとして指定します。

ColorBarオブジェクトの親は,関連付けられている座標軸と同じ親でなければなりません。関連付けられている座標軸の親を変更すると,同じ親を使用するようにColorBarオブジェクトが自動的に更新されます。

このオブジェクトには子がありません。このプロパティは設定できません。

親の孩子们プロパティ内でのオブジェクトハンドルの可視性。次の値のいずれかとして指定します。

オブジェクトが親の孩子们プロパティ内にリストされない場合,オブジェクト階層の検索またはハンドルプロパティのクエリによってオブジェクトハンドルを取得する関数は,そのオブジェクトハンドルを返しません。こうした関数の例としては,関数得到、findobj、gca、gcf、gco、newplot、班、clf,および关闭などが挙げられます。

非表示のオブジェクトハンドルは有効なままです。ルートのShowHiddenHandlesプロパティを“上”に設定すると,HandleVisibilityプロパティの設定にかかわらず,すべてのオブジェクトハンドルがリストされます。

このプロパティは読み取り専用です。

グラフィックスオブジェクトのタイプ。“colorbar”として返されます。

このプロパティを使用して階層内のオブジェクトを検出します。たとえば,関数findobjを使用して特定の类型プロパティ値をもつオブジェクトを検索できます。

オブジェクト識別子。文字ベクトルまたは字符串スカラーとして指定します。オブジェクトの識別子として機能する一意の标签値を指定できます。コードの他の部分からオブジェクトにアクセスする必要がある場合,関数findobjを使用して标签値に基づいてオブジェクトを検索できます。

ユーザーデータ。任意のMATLAB配列として指定します。たとえば、スカラー、ベクトル、行列、cell 配列、文字配列、table、または構造体を指定できます。このプロパティを使用して、任意のデータをオブジェクトに保存します。

程序设计师を使用している場合は,用户数据プロパティを使用する代わりに,アプリでパブリックプロパティまたはプライベートプロパティを作成してデータを共有します。詳細については,程序设计师アプリ内でのデータの共有を参照してください。