Tab

Tab对象表示文件窗口中的一个文件夹标签页（即使标签页控件当前未显示，文件窗口始终至少有一个打开的标签页）。可以从**文件窗口对象获取Tab对象的集合。Tab对象还与Command和Func对象一起使用，如果某条命令导致打开新的标签，则还与Results**对象一起使用。

属性名称	返回类型	说明
all	对象:Items	返回一个**Items**对象，它表示当前在此标签页中显示的所有文件和文件夹。 注意：脚本首次访问此属性（以及所有返回**Items对象的其它属性）时，会截图所有相关项。如果脚本对那些项进行修改（例如，通过创建新文件，修改选择等），集合不会反映这些更改。要重新同步集合，请对该对象调用Update**方法。
backlist	集合：Path	返回一个**Path**对象集合，表示此标签页的“后退”历史记录列表中的路径（即点击“返回”按钮后会进入的文件夹）。
color	字符串	返回标签页的指定颜色（如果已通过例如Go TABCOLOR命令指定了颜色）。颜色以 R、G、B 格式返回为字符串。
crumbpath	对象：Path	返回标签页面包屑控件的当前路径（如果它有一个），包括任何幽灵路径。
dest	布尔值	如果此标签页当前为目标，则返回True，否则返回False。 请注意，如果标签页不是目标，你不能总是认为它是源。为此请使用单独的source属性。
dirs	对象：Items	返回一个**Items**对象，它表示当前在此标签页中显示的所有文件夹。
dirty	布尔值	如果标签页标记为脏的，则返回True，表示其内容列表可能已过时。如果标签页处于后台并且用户已关闭配置/文件夹标签页/选项/处理后台标签页中的文件更改”选项，则可能发生这种情况。
displayed_label	字符串	返回此标签页当前显示的标签。
filegroups	集合：FileGroup	返回一个**FileGroup对象集合，它表示标签页中所有文件组（当标签页被分组时）。可以通过format.group_by**属性测试该标签页是否已分组。
files	对象：Items	返回一个**Items**对象，它表示当前在此标签页中显示的所有文件。
format	对象：Format	返回一个**Format**对象，它表示此标签页中的当前文件夹格式。
forwardlist	集合：Path	返回一个**Path**对象集合，它表示此标签页的“前进”历史记录列表中的路径（即点击“前进”按钮后会进入的文件夹）。
hidden	对象：Items	返回一个**Items**对象，它表示当前在此标签页中隐藏的所有文件和文件夹。
hidden_dirs	对象：Items	返回一个**Items**对象，它表示当前在此标签页中隐藏的所有文件夹。
hidden_files	对象：Items	返回一个**Items**对象，它表示当前在此标签页中隐藏的所有文件
label	字符串	返回当前分配的标签页标签。如果尚未分配自定义标签，请注意这可能是一个空字符串。displayed_label属性在所有情况下都返回当前显示的标签。
linktab	*对象:*Tab	如果此标签页链接到另一个标签页，则返回一个Tab对象，表示该链接的标签页。如果此标签页未链接，此属性返回0。
lister	对象：文件窗口	返回一个**文件窗口**对象，它表示拥有此标签页的父文件窗口。
lock	字符串	返回标签页的当前锁定状态；“关闭”、“开启”、“更改”、“重复使用”之一。
navlock	布尔值	如果此标签页已在导航锁定模式下链接，则返回True。如果标签页未链接，此属性不存在，因此请确保首先检查linktab的值。
path	对象：Path	返回此标签页中显示的当前路径。
quickfilter	对象：QuickFilter	返回一个**QuickFilter**对象，提供此标签页中快速过滤器状态的相关信息。
right	布尔值	如果此标签页当前位于双栏器文件窗口的右侧或底部，则返回True，否则返回False。
selected	对象：Items	返回一个**Items**对象，它表示当前在此标签页中显示的所有选定的文件和文件夹。如果在标签页中已启用复选框模式，这将是已选中的项的集合，而不是选定的项的集合。
selected_dirs	对象：Items	返回一个**Items**对象，它表示当前在此标签页中显示的所有已选中的文件夹。
selected_files	对象：Items	返回一个**Items**对象，它表示当前在此标签页中显示的所有已选中的文件
selstats	对象：TabStats	返回一个**TabStats**对象，它提供有关该标签页的各种信息，包括文件数量、已选择的文件数量、已选择文件的总大小等。此对象提供的“已选择”计数考虑了[复选框模式](/Manual/basic_concepts/selecting_files/selecting_with_the_mouse_and_keyboard/checkbox_mode.zh.md）（即，如果复选框模式当前已启用，则计数将是针对已选中的文件，而不是针对已选择的文件）。
source	布尔值	返回此标签页当前是 源的 True，其它情况下返回 False。 请注意，如果标签页不是源，则不能总是假设它为目标。使用单独的 dest 属性。
stats	object:TabStats	返回一个 TabStats 对象，它提供有关标签页的各种信息，包括文件数量、所选文件数量、选定文件总大小等。与 selstats 不同，此对象不考虑 选择模式 （因此，“已选择”数量将指选中的文件，而不是选中的文件）。
vars	object:Vars	此 Vars 对象表示具有 标签页范围（此标签页的范围）的所有定义变量。
visible	bool	如果此标签页当前可见（即它是文件列表中的活动标签页），则返回 True；否则返回 False。

方法名称	参数	返回类型	描述
Close即时查找	无	无	从 即时查找扩展 脚本调用此方法以强制关闭即时查找字段。
Dlg	无	object:Dialog	创建一个新的 Dialog 对象，该对象允许你显示对话框和弹出菜单。对话框的 window 属性将自动分配给此标签页。
GetFocusItem	无	object:Item	返回一个 Item 对象，表示标签页中获得焦点的文件或文件夹。 焦点项通常用它名称周围的轮廓表示，并且通常是最近单击或使用键盘移动到的最后一个项。焦点项也通常被选中，但并非总是如此；焦点和选择是两件不同的事情。 如果焦点项不存在，或者焦点项是特殊文件或文件夹，例如不能用 Item 对象表示的 此电脑，则此方法不会返回对象。（在 JScript 中，如果结果 == null，则进行测试；在 VBScript 中，如果结果 is nothing，则进行测试。）
Update	无	无	当脚本访问 Tab 对象的特定属性时，会对标签页的状态进行快照。例如，如果你询问 selected_files 属性，所选文件列表将被计算，然后存储在内存中。这可以加快速度，还意味着在处理过程中不必担心列表在你使用时发生更改。如果脚本随后对标签页进行更改（例如，选择文件、创建新文件夹等），如果在同一个标签页对象上再次访问相同属性，缓存的快照不会反映这些更改。要清除缓存的快照并重新同步对象与标签页的当前状态，请调用 Tab.Update 方法。
Update即时查找Suggestions	数组 或 vector:string 或 object:map	无	当实现 即时查找扩展 脚本时，可以随时调用此方法以更新向用户显示的建议列表。 你可以提供一个字符串的数组或 vector，或者提供一个字符串/字符串对的 map。 提供 map 时，每个键表示如果用户选择，则将插入的文本，而值表示提示或描述，该提示或描述显示在建议列表中的单独列中。 提供字符串数组或 vector 时，可以通过用制表符将它与主值分隔来提供第二列描述。