ヘルプセンターヘルプセンター

このページの内容は最新ではありません。最新版の英語を参照するには、ここをクリックします。

プロパティ

プロパティ宣言、属性、およびアクセスメソッド

プロパティはオブジェクトデータを含みます。クラスはすべてのオブジェクトに同じプロパティを定義しますが、それぞれのオブジェクトでは固有のデータ値を格納できます。プロパティの属性は、そのプロパティにアクセス可能な関数とメソッドを制御します。プロパティ値を設定またはクエリしたときに必ず実行される関数を定義できます。コードがプロパティの値にアクセスしたときには、プロパティによってイベントをトリガーできます。

関数

すべて展開する

プロパティの情報

`properties`	クラスプロパティ名
`isprop`	オブジェクトによってプロパティが定義されているかどうかを判別

検証関数

数値属性の検証

`mustBePositive`	値が正であることを検証
`mustBeNonpositive`	値が非正であることを検証
`mustBeNonnegative`	値が非負であることを検証
`mustBeNegative`	値が負であることを検証
`mustBeFinite`	値が有限であることを検証
`mustBeNonNan`	値が NaN でないことを検証
`mustBeNonzero`	値が非ゼロであることを検証
`mustBeNonsparse`	値が非スパースであることを検証
`mustBeReal`	値が実数であることを検証
`mustBeInteger`	値が整数であることを検証
`mustBeNonmissing`	値が欠落していないことを検証 (R2020b 以降)

比較検証

`mustBeGreaterThan`	値が別の値より大きいことを検証
`mustBeLessThan`	値が別の値より小さいことを検証
`mustBeGreaterThanOrEqual`	値が別の値以上であることを検証
`mustBeLessThanOrEqual`	値が別の値以下であることを検証

データ型検証

`mustBeA`	値が指定したクラスのいずれかで取得された値であることを検証 (R2020b 以降)
`mustBeNumeric`	値が数値であることを検証
`mustBeNumericOrLogical`	値が数値または logical であることを検証
`mustBeFloat`	値が浮動小数点配列であることを検証 (R2020b 以降)
`mustBeText`	値が string 配列、文字ベクトル、または文字ベクトルの cell 配列であることを検証 (R2020b 以降)
`mustBeTextScalar`	値が単一のテキストであることを検証 (R2020b 以降)
`mustBeNonzeroLengthText`	値が非ゼロ長のテキストであることを検証 (R2020b 以降)
`mustBeUnderlyingType`	値に基となる型が指定されていることを検証 (R2020b 以降)

サイズ検証

`mustBeNonempty`	値が空でないことを検証
`mustBeScalarOrEmpty`	値がスカラーまたは空であることを検証 (R2020b 以降)
`mustBeVector`	値がベクトルであることを検証 (R2020b 以降)

メンバーと範囲の検証

`mustBeMember`	値が指定集合のメンバーであることを検証
`mustBeInRange`	値が指定した範囲にあることを検証 (R2020b 以降)

特別な意味を持つテキストの検証

`mustBeFile`	パスがファイルを参照していることを検証 (R2020b 以降)
`mustBeFolder`	入力パスがフォルダーを参照していることを検証 (R2020b 以降)
`mustBeValidVariableName`	入力名が有効な変数名であることを検証 (R2020b 以降)

クラス

`dynamicprops`	動的プロパティをサポートするクラスのスーパークラス
`matlab.metadata.DynamicProperty`	Describe dynamic property of MATLAB object
`event.DynamicPropertyEvent`	動的プロパティイベントのイベントデータ
`matlab.metadata.Property`	Describe property of MATLAB class
`matlab.metadata.Validation`	Describes property validation
`matlab.metadata.FixedDimension`	Fixed dimension in property size specification
`matlab.metadata.UnrestrictedDimension`	Unrestricted dimension in property size specification
`matlab.metadata.ArrayDimension`	Size information for property validation
`matlab.lang.OnOffSwitchState`	logical 値でオンおよびオフ状態を表す

トピック

プロパティの定義と属性の設定

プロパティの使用方法
さまざまなユースケースを満たすクラスプロパティを定義できます。
プロパティ構文
動作を制御する属性と検証を使用してクラスプロパティを定義する。
プロパティの属性
属性はプロパティの動作を制御します。
可変プロパティと不変プロパティ
どのコードでプロパティ値を設定できるかを制御することができます。
プロパティ値の初期化
クラスでは既定値をプロパティに代入することができます。これらの値はオブジェクトの作成中に変更できます。
定数値をもつクラスプロパティの定義
Constant プロパティをもつクラスを使用して、定数値を定義する。
オブジェクトを含んだプロパティ
既定値としてオブジェクトが代入されたプロパティは、クラスが最初に読み込まれるときにそのオブジェクトを 1 回だけ作成します。また、格納されているオブジェクトプロパティへの代入の動作は、そのオブジェクトがハンドルか値かによって異なります。

プロパティの検証

プロパティ値の検証
プロパティ値をサイズとクラスに制限し、関数を適用して代入値を検証できます。
プロパティのクラスとサイズの検証
プロパティのクラス要件およびサイズ要件の定義。
プロパティの検証関数
プロパティの検証関数により、プロパティに代入されている値をチェックできます。
プロパティ検証へのメタデータインターフェイス
サイズ、クラス、およびプロパティに割り当てられている値を検証する検証関数について、プログラムにより判別する。

プロパティアクセスメソッド

プロパティの get メソッドおよび set メソッド
プロパティアクセスメソッドは、プロパティ値が参照されたときや代入されたときにコードを実行します。
依存プロパティの get メソッドおよび set メソッド
依存プロパティの get アクセスメソッドおよび set アクセスメソッドを定義する。

動的プロパティ

動的プロパティ — インスタンスへのプロパティの追加
dynamicprops クラスから派生したオブジェクトにインスタンスデータを追加することができます。
動的プロパティの Set メソッドおよび Get メソッド
動的プロパティの事実上のアクセスメソッドを実装することができます。
動的プロパティのイベント
動的プロパティの PropertyAdded イベントと PropertyRemoved イベントにリスナーを定義できます。
動的プロパティと ConstructOnLoad
ConstructOnLoad 属性を使用して、動的プロパティの保存と読み込みを行います。