Main Content

clearTemporaryValue

Clear the temporary value for a setting

Description

example

clearTemporaryValue(s) clears the temporary value for the specified setting. If the temporary value is not set or not writeable, MATLAB® throws an error.

Examples

collapse all

Set and then clear the temporary value for the code font size in MATLAB.

Get the root SettingsGroup object and set the temporary value for the maximum column width for comments in MATLAB.

s = settings
s.matlab.editor.language.matlab.comments.MaxWidth.TemporaryValue = 80;

Display the current values for the maximum column width for comments in MATLAB. Since the temporary value is set, the active value for the setting is the temporary value. For more information on how the active value is determined, see Access and Modify Settings.

s.matlab.editor.language.matlab.comments.MaxWidth
ans = 
 Setting 'matlab.editor.language.matlab.comments.MaxWidth' with properties.

       ActiveValue: 80
    TemporaryValue: 80
     PersonalValue: <no value>
      FactoryValue: 75

Clear the temporary value. The active value for the setting is now set to the factory value.

clearTemporaryValue(s.matlab.editor.language.matlab.comments.MaxWidth)
ans = 
 Setting 'matlab.editor.language.matlab.comments.MaxWidth' with properties.

       ActiveValue: 75
    TemporaryValue: <no value>
     PersonalValue: <no value>
      FactoryValue: 75

Input Arguments

collapse all

Setting, specified as a setting object. Use the settings function to access the root settings group object and all the available settings in the tree.

Introduced in R2018a