CABINA DOBLE “VIP”:
DÍA 8 LAGO BAIKAL (LISTVIANKA) – TRANSIBERIANO Desayuno
Adds a new child to the current Atoll child folder object.
Const SID_PREDICTIONS = "{DA676EF0-E300-4AFF-BBFA-EC55D3798E4F}" Public Sub ExportStudy
Dim oStudy Dim oCS
Set oCS = ActiveDocument.CoordSystemDisplay
For Each oStudy In ActiveDocument.GetRootFolder(0).Item(SID_PREDICTIONS) oStudy.Export "c:\export.asc", oCS, "ARCVIEWGRIDASCII"
oStudy.Export "c:\export.txt", oCS, "TXT" oStudy.Export "c:\export.bmp", oCS, "BMP" Next
End Sub
HRESULT CentreOnMap();
Parameters
[in] spec: VARIANT used to define the child item to add.
[in] position: The position used to define where to add the new child.
[out] pVal: Address of a IChildFolder2 interface pointer used to return the new Atoll child folder object just added.
Remark
The type of the child added depends on the type of the spec input parameter.
When spec if of type VT_UNKNOWN or VT_DISPATCH, and when it is an Atoll ChildFolder object, spec is interpreted as a source ChildFolder object. AddChild will add a link to the source ChildFolder object. The source Atoll ChildFolder cannot be a link itself. Links can only be created at the root level of the Atoll Explorer geo or data tabs. Links always are created at position 0. The source ChildFolder object and the current ChildFolder object must belong to different Atoll documents.
When spec if of type VT_UNKNOWN or VT_DISPATCH, and when it is an Atoll PropertyContainer object, then a new Child- Folder is added with the content of the Atoll PropertyContainer object. The properties needed to actually be able to add a new ChildFolder object depend on the current ChildFolder object type, as returned by ObjectKind.
9.17 Remove
Removes the ChildFolder object from its parent ChildFolder object.
Remarks
A ChildFolder object cannot be used anymore after it is removed. ChildFolder objects may be removed by Atoll, for instance when F5 is used interactively to refresh the screen.
Once this method has returned the ChildFolder object has been destroyed and invoking any method on it will result in unde- fined behaviour.
Atoll version >= 2.8.2:
This method is deprecated. Please use RemoveItem instead.
9.18 get_position
Returns the ChildFolder object position relative to its parent ChildFolder object.
Parameters
[out] pPos: Address of the long integer used to return the ChildFolder object position. ChildFolder objects are ordered from position 0 (top) to to get_Count() - 1 (bottom).
9.19 put_position
Sets the ChildFolder object position relative to its parent ChildFolder object.
Parameters
[in] lPos: A long integer used to specify the ChildFolder object position. • If lPos 0, the ChildFolder object is moved to the top.
HRESULT AddChild(const VARIANT spec, long position, IChildFolder2** pVal)
HRESULT Remove();
HRESULT get_position(long *pPos);
HRESULT put_position(long lPos);
Atoll 3.3.2 Task Automation Guide
Chapter 9: ChildFolder Object © 2016 Forsk. All Rights Reserved.
9.20 get_Object
Access to some specific features on the ChildFolder object.
Parameters
[out] ppObject: Address of the IUnknown interface pointer used to access some specific features.
Remarks
Due to the nature of the interface returned, get_Object cannot be used by macros and scripts. Macros or scripts must use
get_dispatch instead.
9.21 get_dispatch
Access to some specific features on the ChildFolder object.
Parameter
[out] ppDispatch: Address of the IDispatch interface pointer used to access some specific features.
9.22 get_ObjectKind
Returns a type identifier of the ChildFolder object.
Parameters
[out] pRetVal: Address of the BSTR used to return the type identifier.
Remarks
To be able to identify the ChildFolder object type, and therefore to safely access specific features of the ChildFolder object, here is the list of the available type identifiers:
HRESULT get_Object(IUnknown **ppObject);
HRESULT get_dispatch(IDispatch **ppDispatch);
HRESULT get_ObjectKind(BSTR *pRetVal);
Version SID String Value Specific Features
2.4.0 SID_CLUTTER {7CB51DE8-A961-11D2-8688-0060086457D1} Tabular data clutter properties.
2.4.0 SID_SIMULATIONS {CDDF1E1D-1963-4D80-A057-D23A19570984} Simulations folder.
2.4.0 SID_SIMULATIONSGROUP {AF5E2B98-1D54-48FA-89C5-8BFA2936ABF2} "Groups of simulations" folder.
2.4.0 SID_SIMULATION {095C5D90-96F1-4BA8-85BB-B2F990AC2DD9} "Simulation" items.
2.5.1 SID_SITES {90443F68-5B3B-4AFD-B7BB-B057095EBAAD} Sites folder.
2.5.1 SID_ANTENNAS {5FBEB2AE-3BBB-4FBA-94D8-5D8EA5A32069} Antennas folder.
2.5.1 SID_TRANSMITTERS {F7E891E8-F7F5-4870-BF63-AF559AD50FD3} Transmitters folder, in a single-RAT document.
2.5.1 SID_PREDICTIONS {DA676EF0-E300-4AFF-BBFA-EC55D3798E4F} Predictions folder.
2.5.1 SID_UMTS_PARAMETERS {D4F57EE3-7785-4348-9BA6-28998AA6BD80} UMTS Parameters folder.
2.5.1 SID_CW_MEASUREMENTS {41413C4A-C9DE-43DD-A917-612A0AF198FC} CW Measurements folder.
2.5.1 SID_MEASURE_TX {2C102EE5-BFF4-4A5A-8130-02BD0E2F70D7} CW Measurements transmitter.
2.5.1 SID_MEASURE_ITEM {36858A48-7A85-482E-9DA0-B9E935ADE84C} CW Measurements.
2.5.1 SID_TESTMOBILEDATA {21C11380-D8CF-4902-B622-763522AD9FC4} Drive Test Data folder.
2.5.1 SID_NUM_MEASURE_ITEM {916801F9-0539-448C-8C0C-491FAC6399ED} Drive Test Data items.
2.5.1 SID_PARAMETERS_FOLDER {43B8845-5226-454F-908F-59A500DB4FD1} Parameters folder.
2.5.1 SID_HEXAGON_SCHEMA {B167D45E-A0BC-4DC6-B9D7-6F7B131CADF1} Hexagonal Design folder.
2.6.0 SID_TRAFFICFOLDER {B3B25A07-A994-4e8d-BBD1-51556D6C4245} Traffic folder.
2.7.0 SID_PROPAGATIONMODELS {4A2D160B-7D11-4D07-92DF-A3CF6B68D402} Propagation models folder.
2.8.2 {16A53FB3-A961-4EEA-8C30-2387DBF1CC24} Master link ChildFolder object.
2.8.2 {232BDB73-A68F-41A6-A954-75112D907BBF} Link ChildFolder object.
3.1.0 {CC637062-7AFF-4516-BEFB-BCC954E905B1} GSM Transmitters folder, in a multi-RAT document.
3.1.0 {FD147AA0-B9A2-47AC-8CD5-51C77A708AF8} LTE Transmitters folder, in a multi-RAT document.
3.1.0 {090A23A1-EE08-420D-9739-651D1045EF16} UMTS Transmitters folder, in a multi-RAT document.
3.2.0 {65FF5F7D-DBF0-4B52-ABB8-66F3414FD4C3}
CDMA2000 Transmitters folder, in a multi-RAT
document.
3.2.1 StudyFolder A sub-folder of the
predictions folder.
3.3.1 {92CB60E4-BBA1-4318-BB3C-A2E3975C2EC1} GSM Drive Test Data folder, in a multi-RAT document.
3.3.1 {C8542595-9E51-4B4C-950D-BCB0CBAA3153} UMTS Drive Test Data folder, in a multi-RAT document.
3.3.1 {00F8F1C0-FC4D-4A3E-B217-339B86d7EC3B} 1XRTT Drive Test Data folder, in a multi-RAT document.
3.3.1 {368B28F9-8D8D-4C4A-A74B-D101A88C5B7D} LTE Drive Test Data folder, in a multi-RAT document.
3.3.1 {C06DBABF-26C3-40C1-8C19-A11DF7820ADA} KPis folder.
3.3.1 {6332BD99-A54A-4837-B4A6-1C3EE8A22A88} UE Traces folder.
3.3.1 {911FF0FF-242D-47CE-86E8-9618CD5F564C} Weighting Maps folder.
Atoll 3.3.2 Task Automation Guide
Chapter 9: ChildFolder Object © 2016 Forsk. All Rights Reserved.
9.23 GetProperty
Returns a ChildFolder object property.
Parameters
[in] bstrName: A property name.
[out] pValue: Address of the VARIANT used to return the property.
Remarks
The type of the returned VARIANT can be any of the following:
The error E_INVALIDARG is returned when there is no property named bstrName for the ChildFolder object. The properties available for the ChildFolder object depend on the type of the ChildFolder object, as returned by get_ObjectKind.
9.24 SetProperty
Sets a ChildFolder object property.
Parameters
[in] bstrName: A property name.
[in] varValue: The VARIANT used to specify the property value.
Remarks
The error E_INVALIDARG is returned when there is no property named bstrName for the ChildFolder object. The properties available for the ChildFolder object depend on the type of the ChildFolder object, as returned by get_ObjectKind.
9.25 GetPropertiesInfo
Returns names and types for all properties available on the ChildFolder object. HRESULT GetProperty(const BSTR bstrName, VARIANT *pValue);
C++ VBScript VT_BOOL Boolean VT_I4 Integer VT_R4 Single VT_R8 Double VT_UNKNOWN Object
VT_DISPATCH Object, TabularData object, ChildFolder object, PropertyContainer
object
VT_BSTR String
VT_ARRAY | (any of the previous types) Array, with array items of the previous types
HRESULT SetProperty(const BSTR bstrName, const VARIANT varValue);
Parameters
[out] pValue : Address of the VARIANT used to return the names and types for all properties in the property container.
9.26 PropertyIsPropertyContainer
Returns true when a ChildFolder object property is a PropertyContainer object.
Parameters
[in] bstrName : The property name.
[out] pValue: Address of the VARIANT_BOOL used to return whether the property is a PropertyContainer object or not.
9.27 PropertyIsTabularData
Returns true when a ChildFolder object property is a TabularData object.
Parameters
[in] bstrName : The property name.
[out] pValue: Address of the VARIANT_BOOL used to return whether the ChildFolder property type is TabularData object.
9.28 LoadProperties
Sets properties from a property container to the ChildFolder object.
Parameters
[in] varSource : VARIANT of type VT_DISPATCH, used to specify a property container for the properties to set.
9.29 SaveProperties
Saves all the ChildFolder object properties to another property container.
Parameters
[in] varDestination : VARIANT of type VT_DISPATCH, used to specify a property container where all properties will be set.
9.30 RemoveItem
Removes one of the children of the ChildFolder object. HRESULT
PropertyIsPropertyContainer(const BSTR bstrName, VARIANT_BOOL *pValue);
HRESULT PropertyIsTabularData(const BSTR bstrName, VARIANT_BOOL *pValue);
HRESULT LoadProperties(const VARIANT varSource);
HRESULT SaveProperties( const VARIANT varDestination) ;
Atoll 3.3.2 Task Automation Guide
Chapter 9: ChildFolder Object © 2016 Forsk. All Rights Reserved.
Parameters
[in] idx : A VARIANT of type VT_I4 or VT_BSTR used to specify one of the children to remove. If the type of the variant is VT_I4, it is interpreted as a zero-based index in the list of children.
If the type of the variant is VT_BSTR, it is first interpreted as the display name of the child to remove, and if the display name is not found, it is then interpreted as a ChildFolder object kind, as returned by get_ObjectKind.
Remarks
A ChildFolder object cannot be used anymore after it is removed. ChildFolder objects may be removed by the application, for instance when F5 is used interactively to refresh the screen.
This method fails for ChildFolder objects that cannot be removed interactively, and an error is returned in that case.
9.31 SetCustomIcon
Sets the path of an icon to use for a custom child folder.
Parameters
[in] bstrPath : The full path to the icon file (*.ico) to load.
9.32 OpenPropertySheet
Displays the child folder property sheet dialogue.
Parameters:
HRESULT SetCustomIcon(const BSTR bstrPath);
Chapter 10
PropertyContai
ner Object
Atoll 3.3.2 Task Automation Guide
10 PropertyContainer Object
The PropertyContainer object is a generic container containing a set of named properties of arbitrary types. The PropertyContainer object provides the following properties and methods:
10.1 Get
Returns a named property.
Parameters
[in] bstrName: A property name.
[out] pValue: Address of the VARIANT used to return the property.
Remarks
The type of the returned VARIANT can be any of the following:
Name Description Attributes
Get Returns a named property.
Set Sets a named property.
GetInfo Returns names and types for all properties set to the property container.
IsPropertyContainer Returns true when a named property is of a
PropertyContainer object.
Type: Boolean Access: Read
IsTabularData Returns true when a named property is of a TabularData
object.
Type: Boolean Access: Read
Load Adds properties from another property container to the
property container.
Save Saves all the properties to another property container.
RemoveAll Removes all properties from the property container.
Remove Removes a named property from the property container.
HRESULT Get(const BSTR bstrName, VARIANT *pValue);
C++ VBScript VT_BOOL Boolean VT_I4 Integer VT_R4 Single VT_R8 Double VT_UNKNOWN Object
VT_DISPATCH Object, TabularData Object, ChildFolder Object, PropertyContainer
Object
VT_BSTR String
Atoll 3.3.2 Task Automation Guide
Chapter 10: PropertyContainer Object © 2016 Forsk. All Rights Reserved.
The error E_INVALIDARG is returned when the property named bstrName has not been previously set to the property container.
10.2 Set
Sets a named property.
Parameters
[in] bstrName: A property name.
[in] varValue: The VARIANT used to specify the property value.
Remarks
If the property named bstrName has been previously set, its content is replaced by varValue, otherwise a new property named
bstrName is added to the property container.
10.3 GetInfo
Returns names and types for all properties set to the property container.
Parameters
[out] pValue : Address of the VARIANT used to return the names and types for all properties in the property container.
10.4 IsPropertyContainer
Returns true when a named property is a PropertyContainer object.
Parameters
[in] bstrName : The property name.
[out] pValue: Address of the VARIANT_BOOL used to return whether the property is a PropertyContainer Object.
10.5 IsTabularData
Returns true when a named property is a TabularData object.
Parameters
[in] bstrName : The property name.
[out] pValue: Address of the VARIANT_BOOL used to return whether the property is a Tabular Data Object.
10.6 Load
Adds properties from another property container to the property container.
HRESULT Set(const BSTR bstrName, const VARIANT varValue);
HRESULT GetInfo(VARIANT *pValue);
HRESULT IsPropertyContainer(const BSTR bstrName, VARIANT_BOOL *pValue);
Parameters
[in] varSource : VARIANT of type VT_DISPATCH, used to specify a property container for the properties to add.
10.7 Save
Saves all the properties to another property container.
Parameters
[in] varDestination : VARIANT of type VT_DISPATCH, used to specify a property container where all properties will be set.
10.8 RemoveAll
Removes all properties from the property container.
10.9 Remove
Removes a named property from the property container.
Parameters
[in] bstrName : The property name.
[out] pValue: Address of the VARIANT used to return the original property value, before it is removed. HRESULT Load(const VARIANT varSource);
HRESULT Save(const VARIANT varDestination);
HRESULT RemoveAll();
Atoll 3.3.2 Task Automation Guide
Chapter 11
ChildFolder
Object
Properties
Atoll 3.3.2 Task Automation Guide
11 ChildFolder Object Properties
ChildFolder object properties are named properties. The set of available properties for a given ChildFolder object depends on the ChildFolder object type, returned by get_ObjectKind.
ChildFolder object property names usually resemble their GUI representations in the properties dialogues inside Atoll. ChildFolder object properties are divided into the following groups according to their use and application in Atoll:
• "Common ChildFolder Object Properties" on page 136, • "Predictions Folder Properties" on page 137,
• "Coverage Prediction Properties" on page 137, • "GSM Simulation Group Properties" on page 146, • "UMTS Simulation Group Properties" on page 147,
• "WiMAX and LTE Simulation Group Properties" on page 148, • "3GPP Multi-RAT Simulation Group Properties" on page 149, • "Standard Propagation Model Properties" on page 150, • "CW Measurement Properties" on page 152,
• "Drive Test Data Properties" on page 153,
• "Custom ChildFolder Object Properties" on page 153, • "Master Link Properties" on page 154,
• "Link Properties" on page 154, • "Vector Layer Properties" on page 154.