Stateflow.Annotation
チャート、ステート、ボックス、または関数内の注釈
説明
Stateflow.Annotation
オブジェクトは、チャートに説明のコメントを含めるために使用します。注釈には、次のものを任意に組み合わせて含めることができます。
テキスト
イメージ
TeX コマンドを使用した方程式
Web サイトを開くか MATLAB® 関数を実行するハイパーリンク
詳細については、チャート内への説明コメントの追加を参照してください。
作成
説明
入力引数
parent
— 新しい注釈の親
Stateflow.Chart
オブジェクト | Stateflow.State
オブジェクト | Stateflow.Box
オブジェクト | Stateflow.Function
オブジェクト
新しい注釈の親。次のいずれかのタイプの Stateflow® API オブジェクトとして指定します。
プロパティ
Stateflow API オブジェクトには、Stateflow エディターで設定した値に対応するプロパティがあります。プロパティにアクセスするかプロパティを変更するには、ドット表記を使用します。複数の API オブジェクトの複数のプロパティにアクセスするか、それらを変更するには、関数 get
および関数 set
をそれぞれ使用します。詳細については、Stateflow オブジェクトのプロパティの変更と関数の呼び出しを参照してください。
内容
Text
— 注釈のテキスト
"?"
(既定値) | string スカラー | 文字ベクトル
注釈のテキスト。string スカラーまたは文字ベクトルとして指定します。
Alignment
— テキストの配置
"LEFT"
(既定値) | "CENTER"
| "RIGHT"
注釈テキストの配置。"LEFT"
、"CENTER"
、または "RIGHT"
として指定します。
Interpretation
— テキストの形式
"OFF"
(既定値) | "RICH"
| "TEX"
注釈テキストの形式。"OFF"
、"RICH"
、または "TEX"
として指定します。
PlainText
— 書式なしのテキスト
文字ベクトル
この プロパティ は読み取り専用です。
書式なしの注釈テキスト。文字ベクトルとして指定します。
IsImage
— 注釈にイメージを含めるかどうか
false
または 0 (既定値) | true
または 1
この プロパティ は読み取り専用です。
注釈にイメージを含めるかどうか。数値あるいは logical の 1 (true
) または 0 (false
) として指定します。
グラフィカルな外観
Position
— 注釈ボックスの位置とサイズ
[0 0 8 16]
(既定値) | [left top width height]
注釈ボックスの位置とサイズ。[left top width height]
形式の 4 要素数値ベクトルとして指定します。
InternalMargins
— テキストと注釈ボックスの境界の間のスペース
[0 0 0 0]
(既定値) | [left top right bottom]
テキストと注釈ボックスの境界の間のスペース。[left top right bottom]
形式の 4 要素数値ベクトルとして指定します。
DropShadow
— 注釈ボックスの周りに影を表示するかどうか
false
または 0 (既定値) | true
または 1
注釈ボックスの周りに影を表示するかどうか。数値あるいは logical の 1 (true
) または 0 (false
) として指定します。
FixedHeight
— 注釈ボックスの高さを固定するかどうか
false
または 0 (既定値) | true
または 1
注釈ボックスの高さを固定するかどうか。数値あるいは logical の 1 (true
) または 0 (false
) として指定します。
true
— 注釈ボックスの高さを固定し、ボックスより長い内容は非表示にします。false
— 内容の追加に合わせて注釈ボックスを縦方向にサイズ変更します。
FixedWidth
— 注釈ボックスの幅を固定するかどうか
false
または 0 (既定値) | true
または 1
注釈ボックスの幅を固定するかどうか。数値あるいは logical の 1 (true
) または 0 (false
) として指定します。
true
— 注釈ボックスの幅を固定し、ボックスより長いテキストは折り返します。false
— 内容の追加に合わせて注釈ボックスを横方向にサイズ変更します。
BackgroundColor
— 背景色
[1 1 1]
(既定値) | [red green blue]
注釈の背景色。赤、緑、青の値を指定する [red green blue]
形式の 3 要素数値ベクトルとして指定します。各要素は 0 ~ 1 の範囲とする必要があります。このプロパティは、AutoBackgroundColor
プロパティが false
である場合にのみ適用されます。
ForegroundColor
— 前景色
[0 0 0]
(既定値) | [red green blue]
注釈の前景色。赤、緑、青の値を指定する [red green blue]
形式の 3 要素数値ベクトルとして指定します。各要素は 0 ~ 1 の範囲とする必要があります。このプロパティは、AutoForegroundColor
プロパティが false
である場合にのみ適用されます。
AutoBackgroundColor
— 既定の背景色を使用するかどうか
true
または 1 (既定値) | false
または 0
既定の背景色を使用するかどうか。数値あるいは logical の 1 (true
) または 0 (false
) として指定します。
true
— 注釈を含むチャートのChartColor
プロパティで指定された既定の色を使用します。false
— 注釈のBackgroundColor
プロパティで指定された色を使用します。
AutoForegroundColor
— 既定の前景色を使用するかどうか
true
または 1 (既定値) | false
または 0
既定の前景色を使用するかどうか。数値あるいは logical の 1 (true
) または 0 (false
) として指定します。
true
— 注釈を含むチャートのStateLabelColor
プロパティで指定された既定の色を使用します。false
— 注釈のForegroundColor
プロパティで指定された色を使用します。
Font
— 注釈テキストのフォント
Stateflow.NoteFont
オブジェクト
注釈テキストのフォント。次のプロパティをもつ Stateflow.NoteFont
オブジェクトとして指定します。
Name
— フォント名。文字ベクトルとして指定します。このプロパティは読み取り専用です。このプロパティの値は、注釈を含むチャートのStateFont.Name
プロパティで設定されます。Angle
— フォントの角度。"NORMAL"
または"ITALIC"
として指定します。Weight
— フォントの太さ。"NORMAL"
または"BOLD"
として指定します。Size
— フォント サイズ。スカラーとして指定します。
例: annotation.Font.Angle = "ITALIC";
例: annotation.Font.Weight = "BOLD";
例: annotation.Font.Size = 8;
コールバック
ClickFcn
— クリック時のコールバック
""
(既定値) | string スカラー | 文字ベクトル
クリック時のコールバック。string スカラーまたは文字ベクトルとして指定します。このコールバックには、注釈をクリックしたときに実行する MATLAB コードが含まれます。
LoadFcn
— モデル読み込み時のコールバック
""
(既定値) | string スカラー | 文字ベクトル
モデル読み込み時のコールバック。string スカラーまたは文字ベクトルとして指定します。このコールバックには、注釈を含むモデルを読み込むときに実行する MATLAB コードが含まれます。
DeleteFcn
— 削除時のコールバック
""
(既定値) | string スカラー | 文字ベクトル
削除時のコールバック。string スカラーまたは文字ベクトルとして指定します。このコールバックには、注釈を削除する前に実行する MATLAB コードが含まれます。
UseDisplayTextAsClickCallback
— 注釈テキストをコールバックとして使用するかどうか
false
または 0 (既定値) | true
または 1
注釈テキストをコールバックとして使用するかどうか。数値あるいは logical の 1 (true
) または 0 (false
) として指定します。このプロパティが有効な場合、注釈をクリックしたときに Text
プロパティの内容がコールバックとして使用されます。
階層
Chart
— 注釈を含むチャート
Stateflow.Chart
オブジェクト
この プロパティ は読み取り専用です。
注釈を含むチャート。Stateflow.Chart
オブジェクトとして指定します。
Subviewer
— 注釈のサブビューアー
Stateflow.Chart
オブジェクト | Stateflow.State
オブジェクト | Stateflow.Box
オブジェクト | Stateflow.Function
オブジェクト
この プロパティ は読み取り専用です。
注釈のサブビューアー。Stateflow.Chart
、Stateflow.State
、Stateflow.Box
、Stateflow.Function
のいずれかのオブジェクトとして指定します。サブビューアーは、注釈をグラフィカルに表示できるチャートまたはサブチャートです。
Machine
— 注釈を含むマシン
Stateflow.Machine
オブジェクト
この プロパティ は読み取り専用です。
注釈を含むマシン。Stateflow.Machine
オブジェクトとして指定します。
Path
— モデルの階層構造における親の場所
文字ベクトル
この プロパティ は読み取り専用です。
モデルの階層構造における注釈の親の場所。文字ベクトルとして指定します。
識別
Description
— 説明
""
(既定値) | string スカラー | 文字ベクトル
注釈の説明。string スカラーまたは文字ベクトルとして指定します。
Document
— ドキュメント リンク
""
(既定値) | string スカラー | 文字ベクトル
注釈のドキュメント リンク。string スカラーまたは文字ベクトルとして指定します。
Tag
— ユーザー定義のタグ
[]
(既定値) | 任意のデータ型 | ...
注釈のユーザー定義のタグ。任意の型のデータとして指定します。
Id
— 一意の識別子
スカラー
この プロパティ は読み取り専用です。
一意の識別子。整数スカラーとして指定します。このプロパティを使用して、注釈をモデル内の他のオブジェクトと区別します。このプロパティの値は、新しい MATLAB セッションを開始するたびに再割り当てされ、オブジェクトが削除されるとリサイクルされる場合があります。
オブジェクト関数
例
チャートへのテキスト注釈の追加
チャート ch
に注釈を追加します。内容は "This is an annotation."
に設定します。
annotation = Stateflow.Annotation(ch);
annotation.Text = "This is an annotation";
チャートへのイメージ注釈の追加
チャート ch
に注釈を追加します。フォルダー myfolder/annotation_images
にあるファイル myImageFile.png
を、注釈のイメージとして使用します。
annotation = Stateflow.Annotation(ch); setImage(annotation, ... fullfile("myfolder","annotation_images","myImageFile.png"));
バージョン履歴
R2017b で導入
MATLAB コマンド
次の MATLAB コマンドに対応するリンクがクリックされました。
コマンドを MATLAB コマンド ウィンドウに入力して実行してください。Web ブラウザーは MATLAB コマンドをサポートしていません。
Select a Web Site
Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select: .
You can also select a web site from the following list:
How to Get Best Site Performance
Select the China site (in Chinese or English) for best site performance. Other MathWorks country sites are not optimized for visits from your location.
Americas
- América Latina (Español)
- Canada (English)
- United States (English)
Europe
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)