Home > Working with SGWorld > ProjectTree (IProjectTree6) > SaveAsFly
This method saves the specified group to a FLY file. For security reasons the file is saved to a predefined “Skyline\TerraExplorer” folder in the “Application Data” space of the current user. You can use %APPDATA% in Windows Explorer to locate the path on your computer.
Note: If the folder contains a file by the same name, the existing file is overwritten without a prompt.
Note: The Application Data folder path changes between different users and different Windows operating systems. To find the path used by your client look at the %APPDATA% environment variable.
JavaScript |
|
SaveAsFly( FlyName, GroupID) |
C# |
|
string SaveAsFly( string FlyName, int GroupID) |
C++ |
|
HRESULT SaveAsFly( BSTR FlyName, LONG_PTR GroupID, BSTR * pVal) |
Parameters
FlyName
The name for the FLY file. If it is not specified, a FLY extension
is added to the file name automatically.
Note: A file name with a full path cannot be used here.
GroupID
The group that is being saved to a FLY. You can obtain the GroupID by one of the following methods:
§ Create the group using IProjectTree6.CreateGroup.
§ Find the group, if you know the name, using IProjectTree6.FindItem.
§ Traverse the Tree using IProjectTree6 methods such as GetNextItem(), until you come to the desired GroupID.
Return Value
pVal
The ID of the FLY file being created.
Exceptions
HRESULT can return any of the values listed in the HRESULT Return Values list, as well as the following values:
TE_E_INFOTREE_PARENTNOTGROUP |
The group ID entered does not represent a valid group in the project tree. |
TE_E_INFOTREE_ITEMNOTGROUP |
The item entered is not a group and therefore cannot be used as a group. |
TE_E_INFOTREE_CANTUSEROOT |
Can not use tree root for this operation |
TE_E_INFOTREE_ITEMISGROUP |
ItemID is a group so an object cannot be retrieved. |