> For the complete documentation index, see [llms.txt](https://chaoses-ib.gitbook.io/directory-opus/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://chaoses-ib.gitbook.io/directory-opus/guan-fang-shou-ce/readme.zh-10/readme.zh-3/readme.zh/favorites.zh.md).

# Favorites

**Favorites** 对象包含所有定义的 [收藏夹文件夹](/directory-opus/guan-fang-shou-ce/readme.zh-1/readme.zh/readme.zh/favorites.zh.md) 的集合。它从 [**DOpus**](/directory-opus/guan-fang-shou-ce/readme.zh-10/readme.zh-3/readme.zh/dopus.zh.md)**.favorites** 属性中获取。

| 属性名称    | 返回类型                                                                                                     | 描述                                                                                                                                  |
| ------- | -------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------- |
| *<默认值>* | *集合:*[**Favorite**](/directory-opus/guan-fang-shou-ce/readme.zh-10/readme.zh-3/readme.zh/favorite.zh.md) | 您可以枚举 **Favorites** 对象以检索各个 [**Favorite**](/directory-opus/guan-fang-shou-ce/readme.zh-10/readme.zh-3/readme.zh/favorite.zh.md) 对象。 |

<table data-header-hidden><thead><tr><th></th><th></th><th></th><th></th></tr></thead><tbody><tr><td>方法// 名称//</td><td><strong>参数</strong></td><td>返回类型</td><td>描述</td></tr><tr><td>Add</td><td>&#x3C;字符串:类型或名称><br>&#x3C;字符串:路径><br>&#x3C;整数:插入位置> 或<br>&#x3C;对象:<a href="/directory-opus/guan-fang-shou-ce/readme.zh-10/readme.zh-3/readme.zh/favorite.zh.md"><strong>Favorite</strong></a>></td><td><em>对象:</em><a href="/directory-opus/guan-fang-shou-ce/readme.zh-10/readme.zh-3/readme.zh/favorite.zh.md"><strong>Favorite</strong></a><br>或 *对象:*<strong>Favorites</strong></td><td><p>将一个新的收藏夹文件夹添加到收藏夹列表。请注意，您对列表所做的更改不会保存，直到您调用 <strong>Save</strong> 方法。</p><p>此方法执行三个不同的功能；它可以添加分隔符、子文件夹或收藏夹文件夹。</p><p>要添加分隔符，参数应为类型字符串 <strong>sep</strong>，可选地后跟插入位置（见下文）。</p><p>例如，<code>Favorites.Add("sep");</code></p><p>您还可以通过将标题名称附加到 <strong>sep:</strong> 前缀来使分隔符成为标题（即在视觉上与其它项目不同的标签）。例如，<code>Favorites.Add("sep:Current Job");</code></p><p>要添加文件夹，第一个参数应该是字符串 <strong>folder:</strong> 后跟文件夹的名称（作为单个参数），可选地后跟插入位置。</p><p>例如，<code>Favorites.Add("folder:Picture Locations");</code></p><p>要添加一个新的收藏夹，第一个参数可以是收藏夹的名称（可选），第二个参数可以是要添加的文件夹的路径，或者可以省略名称，只提供路径。无论哪种情况，您都可以选择在最后一个参数中包含插入位置。</p><p>例如，</p><pre><code>Favorites.Add("myfave", "c:\folder\path");
Favorites.Add("c:\folder\path");
</code></pre><p>在所有三种情况下，新项目默认情况下都添加到末尾，但您可以选择指定一个位置将项目插入到其它位置。例如，将 <strong>0</strong> 指定为插入位置将把它添加到列表的顶部。您可以提供一个数字或另一个 <a href="/directory-opus/guan-fang-shou-ce/readme.zh-10/readme.zh-3/readme.zh/favorite.zh.md"><strong>Favorite</strong></a> 对象。</p><p>例如，<code>Favorites.Add("myfave", "c:\folder\path", 0);</code></p><p>返回值是一个 <a href="/directory-opus/guan-fang-shou-ce/readme.zh-10/readme.zh-3/readme.zh/favorite.zh.md"><strong>Favorite</strong></a> 或一个 <strong>Favorites</strong> 对象（取决于您是添加了子文件夹还是收藏夹文件夹）。</p></td></tr><tr><td>Delete</td><td>&#x3C;对象:<a href="/directory-opus/guan-fang-shou-ce/readme.zh-10/readme.zh-3/readme.zh/favorite.zh.md"><strong>Favorite</strong></a>> 或<br>&#x3C;对象:<strong>Favorites</strong>></td><td><em>无</em></td><td>删除指定的收藏夹或子文件夹。请注意，您对列表所做的更改不会保存，直到您调用 <strong>Save</strong> 方法。</td></tr><tr><td>Find</td><td>&#x3C;字符串:名称><br>&#x3C;整数:索引></td><td>*对象:*<strong>Favorites</strong></td><td><p>允许您找到当前级别下面一个或多个级别下的子文件夹。<strong>name</strong> 参数是子文件夹的名称或路径和名称（例如，"myfave"、"pictures/local" 等）。</p><p>可选的 <strong>index</strong> 参数允许您处理可能存在多个同名子文件夹的情况。<strong>Favorites.Find("pictures", 1);</strong> 将找到当前级别下面名为“pictures”的第二个子文件夹。</p></td></tr><tr><td>Save</td><td><em>无</em></td><td><em>无</em></td><td>保存您对收藏夹列表所做的任何更改。在您调用此方法后，您所做的更改将反映在配置和Listers 中的收藏夹列表中。请注意，您只能对从 <a href="/directory-opus/guan-fang-shou-ce/readme.zh-10/readme.zh-3/readme.zh/dopus.zh.md"><strong>DOpus</strong></a><strong>.favorites</strong> 属性获取的主“根”<strong>Favorites</strong> 对象调用此方法。</td></tr><tr><td>SetName</td><td>&#x3C;字符串:名称></td><td><em>无</em></td><td>更改此子文件夹的名称。请注意，您对列表所做的更改不会保存，直到您调用 <strong>Save</strong> 方法。您只能对引用子文件夹的 <strong>Favorites</strong> 对象调用此方法，而不能对主“根”文件夹调用此方法。</td></tr></tbody></table>