La traduction de cette page n'est pas à jour. Cliquez ici pour voir la dernière version en anglais.

Propriétés

Déclaration des propriétés, attributs et méthodes d’accès

Les propriétés contiennent des données relatives aux objets. Les classes définissent les même propriétés pour tous les objets mais chaque objet peut avoir des valeurs de données uniques. Les attributs d’une propriété contrôlent les fonctions ou méthodes qui peuvent accéder à celle-ci. Vous pouvez définir des fonctions qui s’exécutent chaque fois que vous définissez ou interrogez les valeurs des propriétés. Les propriétés peuvent déclencher des événements lorsque le code accède à leurs valeurs.

Fonctions

développer tout

Informations sur les propriétés

`properties`	Class property names
`isprop`	Determine if property is defined by object

Fonctions de validation

Validation des attributs avec des valeurs numériques

`mustBePositive`	Validate that value is positive
`mustBeNonpositive`	Validate that value is nonpositive
`mustBeNonnegative`	Validate that value is nonnegative
`mustBeNegative`	Validate that value is negative
`mustBeFinite`	Validate that value is finite
`mustBeNonNan`	Validate that input contains `NaN`
`mustBeNonzero`	Validate that value is nonzero
`mustBeNonsparse`	Validate that value is nonsparse
`mustBeReal`	Validate that value is real
`mustBeInteger`	Validate that value is integer
`mustBeNonmissing`	Validate that input does not contain missing values

Validation des comparaisons

`mustBeGreaterThan`	Validate that value is greater than another value
`mustBeLessThan`	Validate that value is less than another value
`mustBeGreaterThanOrEqual`	Validate that value is greater than or equal to another value
`mustBeLessThanOrEqual`	Validate that value is less than or equal to another value

Validation membre d'un ensemble et plage de valeurs

`mustBeMember`	Validate that value is member of specified set
`mustBeBetween`	Validate that all elements are within specified range (depuis R2025a)

Validation des types de données

`mustBeA`	Validate that value comes from one of specified classes
`mustBeNumeric`	Validate that value is numeric
`mustBeNumericOrLogical`	Validate that value is numeric or logical
`mustBeFloat`	Validate that value is floating-point array
`mustBeText`	Validate that value is string array, character vector, or cell array of character vectors
`mustBeTextScalar`	Validate that value is single piece of text
`mustBeNonzeroLengthText`	Validate that value is text with nonzero length
`mustBeUnderlyingType`	Validate that value has specified underlying type

Validation de la taille

`mustBeNonempty`	Validate that value is nonempty
`mustBeScalarOrEmpty`	Validate that value is scalar or empty
`mustBeVector`	Validate that value is vector

Validation du texte ayant une signification particulière

`mustBeFile`	Validate that path refers to file
`mustBeFolder`	Validate that input path refers to folder
`mustBeValidVariableName`	Validate that input name is valid variable name

Classes

`dynamicprops`	Superclass for classes that support dynamic properties
`matlab.metadata.DynamicProperty`	Describe dynamic property of MATLAB object
`event.DynamicPropertyEvent`	Event data for dynamic property events
`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`	Represent on and off states with logical values

Rubriques

Définir des propriétés et des attributs

Ways to Use Properties
Class properties can be defined to satisfy different use cases.
Property Syntax
Define class properties using attributes and validators that control behavior.
Property Attributes
Attributes control the behavior of properties.
Mutable and Immutable Properties
You can control what code can set property values.
Initialize Property Values
Classes can assign default values to properties, and you can change these values during object construction.
Define Class Properties with Constant Values
Use a class with Constant properties to define constant values.
Properties Containing Objects
Properties assigned objects as default values construct that object only once when the class is first loaded. Also, assignment to contained object properties behaves differently depending on whether the object is a handle or value.

Validation des propriétés

Validate Property Values
You can restrict property values to a size and class, and apply functions to validate assigned values.
Property Class and Size Validation
Define class and size requirements for a property.
Property Validation Functions
Property validation functions enable you to check the values being assigned to properties.
Metadata Interface to Property Validation
Programmatically determine the size, class, and validation functions that validate the values assigned to properties.

Méthodes d’accès aux propriétés

Property Get and Set Methods
Property access methods execute code when property values are referenced or assigned.
Get and Set Methods for Dependent Properties
Define get and set access methods for dependent properties.

Propriétés dynamiques

Dynamic Properties — Adding Properties to an Instance
You can add instance data to an object derived from the dynamicprops class.
Set and Get Methods for Dynamic Properties
You can implement what are effectively access methods for dynamic properties.
Dynamic Property Events
You can define listeners for PropertyAdded and PropertyRemoved events on dynamic properties.
Dynamic Properties and ConstructOnLoad
Use the ConstructOnLoad attribute to save and load dynamic properties.