IOTABuildConfiguration140

Provides access to a Build Configuration. For methods that take a "PropName" parameter, the list of valid PropNames can be found in the following source files:

  DCCStrs.pas:   names for Delphi compiler options
  BCCStrs.pas:   names for the C++ compiler options
  ILinkStrs.pas: names for the C++ linker options
  TLibStrs.pas:  names for the TLib tool options
  TasmStrs.pas:  names for the turbo assembler options
  BRCCStrs.pas:  names for the resource compiler options
  CommonOptionStrs.pas: names for general project options shared between Delphi and C++
  CppCommonOptionStrs.pas: names for general C++ project options

IOTABuildConfiguration140 methods and properties.

---

Up to Parent: IUnknown

Method	Description
GetName	Get the name of the configuration. This may be translated
SetName	Set the name of this configuration
GetKey	Return the configuration's unique key -- this is non-translatable
GetChildCount	Return the number of configurations based directly on this build configuration, including local overrides.
GetChild	Return the index'd configuration based directly on this build configuration, including local overrides.
GetPropertyCount	Return the number of properties specified at this configuration.
GetPropertyName	Return the index'd property specified at this configuration.
IsEmpty	Returns whether or not the configuration has any properties at all.
IsModified	Returns whether or not the configuration has been modified since last save.
Remove	Remove all properties with name "PropName" from the configuration.
Clear	Remove all properties.
PropertyExists	Returns true if the property "PropName" has any value, including a null or empty value, false if no property of that name exists in the configuration.
GetValue	Retrieve the value of property "PropName" recursing through parent configurations. Returns empty string if the property doesn't exist. Can't tell empty properties from non-existent ones, use PropertyExists() to determine if a property actually is specified.
GetValue	Perform an evaluation the value of property "PropName" as a string, optionally recursing through parent configurations. If IncludeInheritedValues=false, the value is determined at this configuration only.
SetValue	Set the value of property "PropName".
GetBoolean	Perform a full evaluation the value of property "PropName" as a boolean, recursing through parent configurations to determine the value if none is specified on this configuration. Assumes empty value to be 'false' if no default value for the property is specified. Raises an exception if the property value cannot be converted to a boolean.
GetBoolean	Perform an evaluation the value of property "PropName" as a boolean, optionally recursing through parent configurations. If IncludeInheritedValues=false, the value is determined at this configuration only. Assumes empty value to be 'false' if no default value for the property is specified. Raises an exception if the property value cannot be converted to a boolean.
SetBoolean	Sets value of "PropName" as a boolean on this configuration.
GetInteger	Perform a full evaluation the value of property "PropName" as an integer, recursing through parent configurations to determine the value if none is specified on this configuration. Raises an exception if the property value cannot be converted to an integer.
GetInteger	Perform an evaluation the value of property "PropName" as an integer, optionally recursing through parent configurations. If IncludeInheritedValues=false, the value is determined at this configuration only. Assumes empty value to be 'false' if no default value for the property is specified. Raises an exception if the property value cannot be converted to an integer.
SetInteger	Sets value of "PropName" as an integer on this configuration
GetValues	Perform an evaluation the value of property "PropName" as a string list, optionally recursing through parent configurations. If IncludeInheritedValues=false, the value is determined at this configuration only.
ContainsValue	For properties that are a list type, return whether or not the property "PropName" contains "Value" as one of its elements.
InsertValues	Insert one or more values into a list-type property, at index 'Location'.
SetValues	Replaces all values of list-type property "PropName" with "Values".
RemoveValues	Removes 'Values' from list-type properties if they exist.
InheritedValues	Evaluates the value of "PropName" up to, but not including, this build configuration as a string list. Only valid for list-type properties.
GetMerged	Return whether or not the property inherits values from its parent configuration. Merging only makes sense for list-type properties. To illustrate: If a parent configuration defines a property as: ListItem1;ListItem2 and a child configuration defines the same property as: ListItem3;ListItem4 then if the property is merged, the fully-merged value in the child configuration would be: ListItem3;ListItem4;ListItem1;ListItem2. If the property is not merged, the value in the child configuration would be just: ListItem3;ListItem4 In the project file, merged properties contain a reference to their own name as one of their values:<PropertyName>ListItem3;Listitem4;$(PropertyName)</PropertyName>
SetMerged	Controls whether or not the property "PropName" has it's value merged with inherited values from parent configurations.

Property	Description
Name	Calls GetName or SetName.
Key	Calls GetKey.
Parent	Calls GetParent.
ChildCount	Calls GetChildCount.
Children	Calls GetChild ro return the Index'd item.
PropertyCount	Calls GetPropertyCount.
Properties	Calls GetPropertyName to return the Index'd item.
Value	Calls GetValue or SetValue.
AsBoolean	Calls GetBoolean or SetBoolean.
AsInteger	Calls GetInteger or SetInteger.
Merged	Calls GetMerged or SetMerged.