【翻译】2.5Beta新插件——FileView

suixin812

FileView用于检索文件夹和文件的信息。
这个插件搜集指定文件夹中的所有文件夹和文件的名字、大小、日期和图标。
它计算文件夹和文件的数量并获得总计大小。
它同时也可以通过递归获取指定文件夹的子文件夹的总文件数和总计大小。

FileView具有父子结构。父FileView用于获取指定文件夹的所有信息，而子FileView则通过“Path=”选项从父FIleView来读取个别的条目。

使用

1. [Rainmeter]
   
2. Update=1000
   
3. DynamicWindowSize=1
   
4. 
   
5. [MeasureFolder]
   
6. Measure=Plugin
   
7. Plugin=FileView
   
8. Path="C:\Program Files\Rainmeter"
   
9. ShowDotDot=0
   
10. ShowFolder=0
    
11. Count=3

复制代码

在这个例子中，父FileView获取指定文件夹下所有文件的名字、大小、日期和图片信息，然后为前三个文件创建了对应的三个索引值。随后的子FileView将用到这三个索引值。

1. [MeasureChild1]
   
2. Measure=Plugin
   
3. Plugin=FileView
   
4. Path=[MeasureFolder]
   
5. Type=FileName
   
6. Index=1
   
7. 
   
8. [MeasureChild2]
   
9. Measure=Plugin
   
10. Plugin=FileView
    
11. Path=[MeasureFolder]
    
12. Type=FileName
    
13. Index=2
    
14. 
    
15. [MeasureChild3]
    
16. Measure=Plugin
    
17. Plugin=FileView
    
18. Path=[MeasureFolder]
    
19. Type=FileName
    
20. Index=3

复制代码

子FileView现在将返回父FileView索引编号对应1到3的三个文件的文件名（FileName）。

另一个使用子FileView的例子：

1. [MeasureChild1]
   
2. Measure=Plugin
   
3. Plugin=FileView
   
4. Path=[MeasureFolder]
   
5. Type=FileName
   
6. Index=1
   
7. 
   
8. [MeasureChild2]
   
9. Measure=Plugin
   
10. Plugin=FileView
    
11. Path=[MeasureFolder]
    
12. Type=FileSize
    
13. Index=1
    
14. 
    
15. [MeasureChild3]
    
16. Measure=Plugin
    
17. Plugin=FileView
    
18. Path=[MeasureFolder]
    
19. Type=FileDate
    
20. Index=1

复制代码

子FileView现在将返回指定文件夹第一个文件（索引1）的文件名（FileName）、大小（FileSize）和日期（FileDate）。

在这些例子中，父FileView通过“Count=3”来创建了3个索引。但这个插件其实能获得所有文件（夹）的信息，而之前的或随后的条目可以被!CommandMeasure指定到这三个索引，下面会描述。这将允许皮肤“滚动显示”文件的信息。

重要提醒：FileView不会对磁盘文件信息进行反复读取，无论是使用UpdateDivider或是一系列的更新Bang都不会使其重新从磁盘读取信息。当!SetVariable或!SetOption修改了父FileView的设置需要其重新读取信息时，需要用FileView特定的更新指令来刷新。

1. [MeasureFolder]
   
2. Measure=Plugin
   
3. Plugin=FileView
   
4. Path="C:\ImageFolder"
   
5. Count=3
   
6. 
   
7. [MeterChangeFolder]
   
8. Meter=Image
   
9. W=26
   
10. H=25
    
11. SolidColor=0,0,0,255
    
12. LeftMouseUpAction=[!SetOption MeasureFolder Path "C:\VideoFolder"][!CommandMeasure MeasureFolder Update]

复制代码

如果需要每隔一段时间就更新内容，可以将FileView的刷新指令与OnUpdateAction结合起来。注意，大量重复的读取文件信息将占用大量的系统性能，设定自动更新内容时需要设定UpdateDivider。

1. [MeasureFolder]
   
2. Measure=Plugin
   
3. Plugin=FileView
   
4. Path="C:\ImageFolder"
   
5. Count=3
   
6. UpdateDivider=5
   
7. OnUpdateAction=!CommandMeasure MeasureFolder Update

复制代码

选项

Measure通用选项全部适用。
• Path
  在父Measure，指定文件夹路径。默认值为“我的电脑”
  在子Measure，指定父Measure的名字
  

父Measure选项

• FinishAction
  当插件读取完文件信息时执行的动作。
• Recursive
  递归。
  当设定为1时，插件将检索所有的子文件并只更新文件数量、文件夹数量、总计文件夹大小。
  （If set to 1, the plugin searches all sub-folders updating only the file count, folder count and overall folder size. This option does not index specific files in sub-folders.）
  （If set to 2, the plugin indexes all files in the folder tree defined in Path. Folders are not indexed. Plugin commands FollowPath and PreviousFolder are disabled, and ShowFile, ShowFolder, and ShowDotDot options have no effect.）
  当设定为2时，插件将为指定路径的文件树结构下的所有文件编号。文件夹不被编号。插件命令FollowPath和PreviousFolder无效，ShowFile、ShowFolder和ShowDotDot设置也将无效。
  默认值0.
• Count
  每次进行标号的项目的数量。默认1.
• ShowDotDot
  是否包含文件夹“..”（代表上级目录）。0不包含，1包含。默认1.
• ShowFolder
  是否包含除“..”外的文件夹。0不包含，1包含。默认1.
• ShowFile
  是否包含文件。0不包含，1包含。默认1。
• ShowHidden
  是否包含隐藏文件和文件夹。默认1。
• ShowSystem
  是否显示受保护的系统文件。默认0。
• HideExtensions
  是否隐藏文件扩展名。默认0.
• Extensions
  指定文件扩展名。以英文分号分隔。
  例如，当Extensions="jpg;png"时，只有Jpg和Png文档的信息会被插件读取。
• SortType
  文件信息的排列方式：Name（文件名），Size（大小），Type（类型），Date（日期）。默认Name
• SortDateType
  当文件信息依据日期排列（SortType=Date）时，日期的类型：Modified（最后修改日期），Created（创建日期），Accessed（最后访问日期）
• SortAscending
  1升序排列，0降序排列。默认1.
• WildcardSearch
  筛选文件或文件夹。允许使用通配符*和?。默认值*
  

子Measure选项

• Index
  从父Measure返回文件或文件夹信息相应的索引值。索引值应当小于父Measure的Count，如果索引值超过Count，索引值将被除余（当Count=8时，Index=9等同于Index=1）。
• IgnoreCount
  当值为1时，Index将代表文件或文件夹的实际索引值。这通常用于持续返回某个固定的文件的信息。（当IgnoreCount=1时，无论Count值为多少，Index=9始终返回第九个文件的信息）
• Type
  返回信息的类型：FolderPath（文件夹地址），FolderSize(文件夹大小)，FileCount（文件数量），FolderCount（文件夹数量），FileName（文件名），FileType（文件类型），FileSize（文件大小），FileDate（文件日期），FilePath（文件地址），Icon（图标）
  提示：当Type=Icon时，将返回图标的完整地址（见IconPath）。这使图标可以通过Image类的Meter显示出来。
• IconPath
  当Type=Icon时，设定缓存图标的文件夹地址。默认图标保存在当前皮肤文件夹中，并被命名iconX.ico，X代表索引号。
• IconSize
  保存图标的规格：Small（16x16），Medium（32x32），Large（48x48），ExtraLarge（256x256）
  

插件Bang指令
格式：!CommandMeasure "MeasureName" "指令"

父Measure指令

• Update
  更新Measure，并重新读取信息。
• PageUp
  向前翻页。
  例如，若Count=8，列表中有25个文件，则总共形成4页。若当前显示的是第二页（8-15），PageUp将更改显示的项目为第一页（0-7）
• PageDown
  向后翻页。
• IndexUp
  减少索引编号（前一个）
• IndexDown
  增加索引编号（下一个）
• PreviousFolder
  更改Path为上级文件夹（返回上级目录）。
  

子Measure指令

• FollowPath
  若当前子Measure返回的是文件夹，则更改父Measure的Path为次文件夹；否则，打开文件。
• Open
  打开文件或文件夹。
  

MairoW

看看哈，就看看

夜色之下

not bad  以后编新版本手册的时候 可以引入

刀刀兄

好帖，支持下！

fly2high

这插件不错！支持

Swarupa

看看。。。

落花无情

看起来真不错，确实支持下