VST 3 SDK VST 3.7
SDK for developing VST plug-in
StringListParameter Class Reference

Description of a StringListParameter. More...

#include <vstparameters.h>

+ Inheritance diagram for StringListParameter:

Public Member Functions

 StringListParameter (const ParameterInfo &paramInfo)
 
 StringListParameter (const TChar *title, ParamID tag, const TChar *units=nullptr, int32 flags=ParameterInfo::kCanAutomate|ParameterInfo::kIsList, UnitID unitID=kRootUnitId, const TChar *shortTitle=nullptr)
 
 ~StringListParameter () override
 
virtual void appendString (const String128 string)
 Appends a string and increases the stepCount. More...
 
virtual bool replaceString (int32 index, const String128 string)
 Replaces the string at index. More...
 
void toString (ParamValue _valueNormalized, String128 string) const SMTG_OVERRIDE
 Converts a normalized value to a string. More...
 
bool fromString (const TChar *string, ParamValue &_valueNormalized) const SMTG_OVERRIDE
 Converts a string to a normalized value. More...
 
ParamValue toPlain (ParamValue _valueNormalized) const SMTG_OVERRIDE
 Converts a normalized value to plain value (e.g. More...
 
ParamValue toNormalized (ParamValue plainValue) const SMTG_OVERRIDE
 Converts a plain value to a normalized value (e.g. More...
 
- Public Member Functions inherited from Parameter
 Parameter ()
 
 Parameter (const ParameterInfo &)
 
 Parameter (const TChar *title, ParamID tag, const TChar *units=nullptr, ParamValue defaultValueNormalized=0., int32 stepCount=0, int32 flags=ParameterInfo::kCanAutomate, UnitID unitID=kRootUnitId, const TChar *shortTitle=nullptr)
 
 ~Parameter () override
 
virtual const ParameterInfogetInfo () const
 Returns its read only info. More...
 
virtual ParameterInfogetInfo ()
 Returns its writable info. More...
 
virtual void setUnitID (UnitID id)
 Sets its associated UnitId. More...
 
virtual UnitID getUnitID ()
 Gets its associated UnitId. More...
 
ParamValue getNormalized () const
 Gets its normalized value [0.0, 1.0]. More...
 
virtual bool setNormalized (ParamValue v)
 Sets its normalized value [0.0, 1.0]. More...
 
virtual void toString (ParamValue valueNormalized, String128 string) const
 Converts a normalized value to a string. More...
 
virtual bool fromString (const TChar *string, ParamValue &valueNormalized) const
 Converts a string to a normalized value. More...
 
virtual ParamValue toPlain (ParamValue valueNormalized) const
 Converts a normalized value to plain value (e.g. More...
 
virtual ParamValue toNormalized (ParamValue plainValue) const
 Converts a plain value to a normalized value (e.g. More...
 
virtual int32 getPrecision () const
 Gets the current precision (used for string representation of float). More...
 
virtual void setPrecision (int32 val)
 Sets the precision for string representation of float value (for example 4.34 with 2 as precision). More...
 

Public Attributes

OBJ_METHODS(StringListParameter, Parameter) protected StringVector strings
 
- Public Attributes inherited from Parameter
OBJ_METHODS(Parameter, FObject) protected ParamValue valueNormalized {0.}
 
int32 precision {4}
 

Detailed Description

Description of a StringListParameter.

Constructor & Destructor Documentation

◆ StringListParameter() [1/2]

StringListParameter ( const ParameterInfo paramInfo)

◆ StringListParameter() [2/2]

StringListParameter ( const TChar title,
ParamID  tag,
const TChar units = nullptr,
int32  flags = ParameterInfo::kCanAutomate | ParameterInfo::kIsList,
UnitID  unitID = kRootUnitId,
const TChar shortTitle = nullptr 
)

◆ ~StringListParameter()

~StringListParameter ( )
override

Member Function Documentation

◆ appendString()

void appendString ( const String128  string)
virtual

Appends a string and increases the stepCount.

◆ replaceString()

bool replaceString ( int32  index,
const String128  string 
)
virtual

Replaces the string at index.

Index must be between 0 and stepCount+1

◆ toString()

void toString ( ParamValue  _valueNormalized,
String128  string 
) const
virtual

Converts a normalized value to a string.

Reimplemented from Parameter.

◆ fromString()

bool fromString ( const TChar string,
ParamValue _valueNormalized 
) const
virtual

Converts a string to a normalized value.

Reimplemented from Parameter.

◆ toPlain()

ParamValue toPlain ( ParamValue  _valueNormalized) const
virtual

Converts a normalized value to plain value (e.g.

0.5 to 10000.0Hz).

Reimplemented from Parameter.

◆ toNormalized()

ParamValue toNormalized ( ParamValue  plainValue) const
virtual

Converts a plain value to a normalized value (e.g.

10000 to 0.5).

Reimplemented from Parameter.

Member Data Documentation

◆ strings

OBJ_METHODS (StringListParameter, Parameter) protected StringVector strings
Empty

Copyright © Steinberg Media Technologies GmbH. All Rights Reserved. This documentation is under this license.