Favorites

The Favorites object holds a collection of all the defined favorite folders. It is retrieved from the DOpus.favorites property.
 

Property Name

Return Type

Description

<default value>

collection:Favorite

You can enumerate the Favorites object to retrieve individual Favorite objects.

 

Method Name

Arguments

Return Type

Description

Add

<string:typeOrName>
<string:path>
<int:insertpos> or
<object:Favorite>

object:Favorite
or object:Favorites

Adds a new favorite folder to the favorites list. Note that changes you make to the list are not saved until you call the Save method.

 

This method performs three separate functions; it can add a separator, a sub-folder or a favorite folder. 

  • To add a separator, the parameters should be the type string sep, optionally followed by the insertion position (see below).

    For example, Favorites.Add("sep");
     
  • To add a folder, the first parameter should be the string folder: followed by the name of the folder (as a single parameter), optionally followed by the insertion position.

    For example, Favorites.Add("folder:Picture Locations");
     
  • To add a new favorite, the first parameter can optionally be the name of the favorite, and the second parameter can be the path of the folder to add, or the name can be omitted and only the path can be provided. In either case you can optionally include the insertion position as the last parameter.

    For example, Favorites.Add("myfave", "c:\folder\path");
    or Favorites.Add("c:\folder\path"); 

In all three cases the new item is added to the end by default, but you can optionally specify a position to insert the item somewhere else. E.g. specifying 0 for the insertion position would add it at the top of the list. You can provide either a number or another Favorite object.


For example, Favorites.Add("myfave", "c:\folder\path", 0);

 

The return value is either a Favorite or a Favorites object (depending on whether you added a sub-folder or a favorite folder). 

Delete

<object:Favorite> or
<object:Favorites>

none

Deletes the specified favorite or sub-folder. Note that changes you make to the list are not saved until you call the Save method.

Find

<string:name>
<int:index>

object:Favorites

Lets you locate a sub-folder one or more levels below the current one. The name parameter is the name or path and name of the sub-folder to look for (e.g. "myfave", "pictures/local", etc).

The optional index parameter lets you handle the case when there might be more than one sub-folder with the same name. Favorites.Find("pictures", 1); would find the second sub-folder called "pictures" below the current level.

Save

none

none

Saves any changes you've made to the favorites list. Once you call this method changes you have made will be reflected in Preferences and the favorites list in Listers. Note that you can only call this method on the main "root" Favorites object obtained from the DOpus.favorites property

SetName

<string:name>

none

Changes the name of this sub-folder. Note that changes you make to the list are not saved until you call the Save method. You can only call this method on Favorites objects that refer to sub-folders, and not the main "root" folder.