收藏夹

收藏夹对象保存所有已定义的 收藏夹文件夹 的集合。它从 DOpus.favorites 属性中检索。

属性名	返回类型	说明
<默认值>	集合:收藏夹	你可以枚举 收藏夹对象以检索各个 收藏夹 对象。

方法// 名称//	参数	返回类型	说明
添加	<字符串:typeOrName> <字符串:path> <int:insertpos> 或 <对象:收藏夹>	对象:收藏夹 或 *对象:*收藏夹	将新的收藏夹文件夹添加到收藏夹列表。请注意，在你调用 保存 方法之前，你对列表所做的更改不会被保存。 此方法执行三个单独的功能；它可以添加分隔符、子文件夹或收藏夹文件夹。 要添加分隔符，参数应为类型字符串 sep，后跟可选的插入位置（见下文）。 例如，Favorites.Add("sep"); 还可以通过将标题名称附加到 sep: 前缀来使分隔符成为标题（即与其它项目在视觉上有所不同的标签）。例如，Favorites.Add("sep:Current Job"); 要添加文件夹，第一个参数应该是字符串 folder:，后跟文件夹的名称（作为单个参数），后跟可选的插入位置。 例如，Favorites.Add("folder:Picture Locations"); 要添加新的收藏夹，第一个参数可以是收藏夹的名称（可选），第二个参数可以是所添加文件夹的 路径，或可以省略名称，而只提供路径。在任何一种情况下，你都可以选择将插入位置作为最后一个参数包含在内。 例如， Favorites.Add("myfave", "c:\folder\path"); Favorites.Add("c:\folder\path"); 在这三种情况下，默认情况下，新项目都会被添加到末尾，但你可以选择指定一个位置将该项目插入到其它位置。例如，为插入位置指定 0 将它添加到列表的顶部。你可以提供一个数字或另一个 **收藏夹**对象。 例如，Favorites.Add("myfave", "c:\folder\path", 0); 返回值是 **收藏夹**或 收藏夹 对象（取决于你添加的是子文件夹还是收藏夹文件夹）。
删除	<对象:收藏夹> 或 <对象:收藏夹>	无	删除指定的收藏夹或子文件夹。请注意，在你调用 保存 方法之前，你对列表所做的更改不会被保存。
查找	<字符串:name> <int:index>	*对象:*收藏夹	让你找到当前一个级别以下一个或多个级别的子文件夹。名称参数是所要查找的子文件夹的名称或路径和名称（例如 "myfave"、"pictures/local" 等）。 可选的 index 参数让你能够处理当有多个子文件夹具有相同名称时的情形。Favorites.Find("pictures", 1); 将找到当前级别以下名为 "pictures" 的第二个子文件夹。
保存	无	无	保存你对收藏夹列表所做的任何更改。一旦你调用此方法，你所做的更改将反映在配置中，以及文件窗口中的收藏夹列表中。请注意，你只能在从 DOpus.favorites 属性获取的主 "根" 收藏夹 对象上调用此方法
设置名称	<字符串:name>	无	更改此子文件夹的名称。请注意，在你调用 保存 方法之前，你对列表所做的更改不会被保存。你只能对引用子文件夹（而不是主 "根" 文件夹）的 收藏夹 对象调用此方法。