sfpref

Set preferences for Stateflow charts

Syntax

allSettings = sfpref

setting = sfpref(preference)

setting = sfpref(ActionLanguage=actionLanguage)

setting = sfpref(PatternWizardCustomDir=customPatternFolder)

setting = sfpref(EnableLabelAutoCorrectionForMAL=autoCorrection)

setting = sfpref(ShowTransitionLabelOwner=transitionLabelLines)

Description

allSettings = sfpref returns the Stateflow^® preferences and settings.

setting = sfpref(preference) returns the setting for the specified preference.

setting = sfpref(ActionLanguage=actionLanguage) sets the default action language used by new Stateflow charts and state transition tables. For more information, see Change the Default Action Language.

setting = sfpref(PatternWizardCustomDir=customPatternFolder) sets the custom pattern folder used by the Pattern Wizard. For more information, see Save Custom Flow Chart Patterns.

setting = sfpref(EnableLabelAutoCorrectionForMAL=autoCorrection) enables or disables automatic correction of common C constructs in Stateflow charts that use MATLAB^® as the action language. For more information, see Auto Correction When Using MATLAB as the Action Language.

setting = sfpref(ShowTransitionLabelOwner=transitionLabelLines) enables or disables indicator lines between transitions and associated labels.

Examples

Display Settings for All Preferences

Display the settings for all Stateflow preferences.

sfpref

ans = 

  struct with fields:

                               ActionLanguage: 'MATLAB'
              EnableLabelAutoCorrectionForMAL: 1
                       PatternWizardCustomDir: ''
                     ShowTransitionLabelOwner: 0

Display Default Action Language

Display the default action language used by new Stateflow charts and state transition tables.

sfpref("ActionLanguage")

ans =

    'MATLAB'

Change Default Action Language

Change the default action language used by new Stateflow charts and state transition tables to C.

sfpref(ActionLanguage="C")

ans =

    'C'

Set Custom Pattern Folder

Set the custom pattern folder used by the Pattern Wizard to C:\patterns.

sfpref(PatternWizardCustomDir=fullfile("C:","patterns"))

ans =

    'C:\patterns'

Disable Automatic Correction of C Constructs

Disable automatic correction of common C constructs in charts that use MATLAB as the action language.

sfpref(EnableLabelAutoCorrectionForMAL=false)

ans =

    0

Display Indicator Lines Between Transitions and Labels

Display an indicator line between every transition and the associated label.

sfpref(ShowTransitionLabelOwner=true)

ans =

    1

Input Arguments

preference — Stateflow preference to return

"ActionLanguage" | "PatternWizardCustomDir" | "EnableLabelAutoCorrectionForMAL" | "ShowTransitionLabelOwner"

Stateflow preference to return, specified as one of these values:

• "ActionLanguage" — Default action language used by new Stateflow charts and state transition tables

• "PatternWizardCustomDir" — Custom pattern folder used by the Pattern Wizard

• "EnableLabelAutoCorrectionForMAL" — Whether Stateflow charts that use MATLAB as the action language automatically correct common C constructs

• "ShowTransitionLabelOwner" — Whether indicator lines appear between transitions and associated labels

actionLanguage — Default action language

"MATLAB" (default) | "C"

Default action language used by new Stateflow charts and state transition tables, specified as "MATLAB" or "C".

customPatternFolder — Custom pattern folder

"" (default) | string scalar | character vector

Custom pattern folder used by the Pattern Wizard, specified as a string scalar or character vector.

Data Types: string | char

autoCorrection — Whether to enable automatic correction of C constructs

true or 1 (default) | false or 0

Whether to enable automatic correction of common C constructs in Stateflow charts that use MATLAB as the action language, specified as a numeric or logical 1 (true) or 0 (false).

transitionLabelLines — Whether to display indicator lines between transitions and labels

false or 0 (default) | true or 1

Whether to display the indicator lines between transitions and associated labels, specified as a numeric or logical 1 (true) or 0 (false), where:

• true — Displays indicator lines for every transition

• false — Displays indicator lines only when label ownership is unclear

Output Arguments

allSettings — Settings for all preferences

structure

Settings for all Stateflow preferences, returned as a structure with these fields:

• ActionLanguage — Default action language used by new Stateflow charts and state transition tables, returned as 'MATLAB' or 'C'

• PatternWizardCustomDir — Custom pattern folder used by the Pattern Wizard, returned as a character vector

• EnableLabelAutoCorrectionForMAL — Whether Stateflow charts that use MATLAB as the action language automatically correct common C constructs, returned as 1 or 0 of data type double

• ShowTransitionLabelOwner — Whether indicator lines appear between transitions and associated labels, returned as 1 or 0 of data type double

setting — Setting for specified preference

any data type, depending on the preference

Setting for specified preference, returned in the format determined by the preference:

• ActionLanguage — 'MATLAB' or 'C'

• PatternWizardCustomDir — character vector

• EnableLabelAutoCorrectionForMAL — 1 or 0 of data type double

• ShowTransitionLabelOwner — 1 or 0 of data type double

Data Types: char | double

Version History

Introduced before R2006a