ChoiceSetting Class Reference

#include <Prefs.h>

Inheritance diagram for ChoiceSetting:

Collaboration diagram for ChoiceSetting:

Public Member Functions
	ChoiceSetting (const SettingBase &key, EnumValueSymbols symbols, long defaultSymbol=-1)
const wxString &	Key () const
const EnumValueSymbol &	Default () const
const EnumValueSymbols &	GetSymbols () const
wxString	Read () const
wxString	ReadWithDefault (const wxString &) const
bool	Write (const wxString &value)
void	SetDefault (long value)

Protected Member Functions
size_t	Find (const wxString &value) const
virtual void	Migrate (wxString &)

Protected Attributes
const wxString	mKey
const EnumValueSymbols	mSymbols
bool	mMigrated { false }
long	mDefaultSymbol

Detailed Description

Packages a table of user-visible choices each with an internal code string, a preference key path, and a default choice

Definition at line 351 of file Prefs.h.

Constructor & Destructor Documentation

ChoiceSetting()

ChoiceSetting::ChoiceSetting ( const SettingBase &  key, EnumValueSymbols  symbols, long  defaultSymbol = -1  )

inline

Definition at line 354 of file Prefs.h.

      : mKey{ key.GetPath() }
 
      , mSymbols{ std::move( symbols ) }
 
      , mDefaultSymbol{ defaultSymbol }
   {
      wxASSERT( defaultSymbol < (long)mSymbols.size() );
   }

Member Function Documentation

Default()

const EnumValueSymbol & ChoiceSetting::Default

(

)

const

Definition at line 315 of file Prefs.cpp.

{
   if ( mDefaultSymbol >= 0 && mDefaultSymbol < (long)mSymbols.size() )
      return mSymbols[ mDefaultSymbol ];
   static EnumValueSymbol empty;
   return empty;
}

References mDefaultSymbol, and mSymbols.

Referenced by Read(), HelpSystem::ShowHelp(), ShuttleGuiBase::TieChoice(), and anonymous_namespace{GetInfoCommand.cpp}::ShuttleGuiGetDefinition::TieChoice().

Here is the caller graph for this function:

Find()

size_t ChoiceSetting::Find ( const wxString &  value ) const

protected

Definition at line 346 of file Prefs.cpp.

{
   auto start = GetSymbols().begin();
   return size_t(
      std::find( start, GetSymbols().end(), EnumValueSymbol{ value, {} } )
         - start );
}

References PackedArray::end(), and GetSymbols().

Referenced by EnumSettingBase::ReadInt(), EnumSettingBase::ReadIntWithDefault(), ReadWithDefault(), and Write().

Here is the call graph for this function:

Here is the caller graph for this function:

GetSymbols()

const EnumValueSymbols & ChoiceSetting::GetSymbols ( ) const

inline

Definition at line 370 of file Prefs.h.

{ return mSymbols; }

Referenced by Find(), ShuttleGuiBase::TieChoice(), and anonymous_namespace{GetInfoCommand.cpp}::ShuttleGuiGetDefinition::TieChoice().

Here is the caller graph for this function:

Key()

const wxString & ChoiceSetting::Key ( ) const

inline

Definition at line 368 of file Prefs.h.

{ return mKey; }

Referenced by ShuttleGuiBase::TieChoice(), and anonymous_namespace{GetInfoCommand.cpp}::ShuttleGuiGetDefinition::TieChoice().

Here is the caller graph for this function:

Migrate()

void ChoiceSetting::Migrate ( wxString &  value )

protectedvirtual

Reimplemented in EnumSettingBase, SpectrogramSettings::ColorSchemeEnumSetting, and TracksViewModeEnumSetting.

Definition at line 354 of file Prefs.cpp.

{
   (void)value;// Compiler food
}

Referenced by ReadWithDefault().

Here is the caller graph for this function:

Read()

wxString ChoiceSetting::Read

(

)

const

Definition at line 323 of file Prefs.cpp.

{
   const auto &defaultValue = Default().Internal();
   return ReadWithDefault( defaultValue );
}

References Default(), ComponentInterfaceSymbol::Internal(), and ReadWithDefault().

Referenced by anonymous_namespace{PluginMenus.cpp}::AddEffectMenuItems(), ExportFLAC::Export(), ThemeBase::LoadPreferredTheme(), anonymous_namespace{PluginMenus.cpp}::PopulateEffectsMenu(), EnumSettingBase::ReadInt(), ThemeBase::SwitchTheme(), ShuttleGuiBase::TieChoice(), ProjectSettings::UpdatePrefs(), and Settings::UpdatePrefs().

Here is the call graph for this function:

Here is the caller graph for this function:

ReadWithDefault()

wxString ChoiceSetting::ReadWithDefault

(

const wxString &

defaultValue

)

const

Definition at line 329 of file Prefs.cpp.

{
   wxString value;
   if ( !gPrefs->Read(mKey, &value, defaultValue) )
      if (!mMigrated) {
         const_cast<ChoiceSetting*>(this)->Migrate( value );
         mMigrated = true;
      }
 
   // Remap to default if the string is not known -- this avoids surprises
   // in case we try to interpret config files from future versions
   auto index = Find( value );
   if ( index >= mSymbols.size() )
      value = defaultValue;
   return value;
}

References Find(), gPrefs, Migrate(), mKey, mMigrated, and mSymbols.

Referenced by Read(), and EnumSettingBase::ReadIntWithDefault().

Here is the call graph for this function:

Here is the caller graph for this function:

SetDefault()

void ChoiceSetting::SetDefault

(

long

value

)

Definition at line 389 of file Prefs.cpp.

{
   if ( value < (long)mSymbols.size() )
      mDefaultSymbol = value;
   else
      wxASSERT( false );
}

References mDefaultSymbol, and mSymbols.

Write()

bool ChoiceSetting::Write

(

const wxString &

value

)

Definition at line 359 of file Prefs.cpp.

{
   auto index = Find( value );
   if (index >= mSymbols.size())
      return false;
 
   auto result = gPrefs->Write( mKey, value );
   mMigrated = true;
   return result;
}

References Find(), gPrefs, mKey, mMigrated, and mSymbols.

Referenced by EnumSettingBase::Migrate(), SpectrogramSettings::ColorSchemeEnumSetting::Migrate(), TracksViewModeEnumSetting::Migrate(), DependencyDialog::SaveFutureActionChoice(), HelpSystem::ShowHelp(), and EnumSettingBase::WriteInt().

Here is the call graph for this function:

Here is the caller graph for this function:

Member Data Documentation

mDefaultSymbol

long ChoiceSetting::mDefaultSymbol

protected

Definition at line 394 of file Prefs.h.

Referenced by Default(), EnumSettingBase::Migrate(), and SetDefault().

mKey

const wxString ChoiceSetting::mKey

protected

Definition at line 387 of file Prefs.h.

Referenced by ReadWithDefault(), and Write().

mMigrated

bool ChoiceSetting::mMigrated { false }

mutableprotected

Definition at line 392 of file Prefs.h.

Referenced by ReadWithDefault(), and Write().

mSymbols

const EnumValueSymbols ChoiceSetting::mSymbols

protected

Definition at line 389 of file Prefs.h.

Referenced by Default(), EnumSettingBase::EnumSettingBase(), EnumSettingBase::Migrate(), EnumSettingBase::ReadIntWithDefault(), ReadWithDefault(), SetDefault(), Write(), and EnumSettingBase::WriteInt().

---

The documentation for this class was generated from the following files:

• Prefs.h
• Prefs.cpp