Documentation

matlab.system.StringSet class

Package: matlab.system

Set of valid character vector values

Description

matlab.system.StringSet specifies a list of valid character vector values for a property. This class validates the character vector in the property and enables tab completion for the property value. A StringSet allows only predefined or customized character vectors as values for the property.

A StringSet uses two linked properties, which you must define in the same class. One is a public property that contains the current character vector value. This public property is displayed to the user. The other property is a hidden property that contains the list of all possible character vector values. This hidden property should also have the transient attribute so its value is not saved to disk when you save the System object™.

The following considerations apply when using StringSets:

  • The property that holds the current character vector can have any name.

  • The property that holds the StringSet must use the same name as the property with the suffix "Set" appended to it. This property is an instance of the matlab.system.StringSet class.

  • Valid character vectors, defined in the StringSet, must be declared using a cell array. The cell array cannot be empty nor can it have any empty character vectors. Valid character vectors must be unique and are case-sensitive.

  • The property must be set to a valid StringSet value.

Examples

expand all

Set the property, Flavor, and the StringSet property, FlavorSet in your class definition file.

properties
  Flavor = 'Chocolate';
end

properties (Hidden,Transient)
  FlavorSet = ...
    matlab.system.StringSet({'Vanilla','Chocolate'});
end

Was this topic helpful?