Kivy - 文件选择器

---

---

在 GUI 应用中，您经常需要从本地文件系统中选择所需文件。Kivy 框架提供“kivy.uix.filechooser”模块，其中包含用于描述、显示和浏览文件系统的各种类。

filechooser 模块中的类采用 MVC 设计。它们可以分为如下几类：

• 模型由FileSystemAbstract类的具体实现表示，例如FileSystemLocal。

• 视图由FileChooserListLayout和FileChooserIconLayout类表示。这些分别由FileChooserListView和FileChooserIconView组件使用。

• 控制器由FileChooserController的具体实现表示，即FileChooser、FileChooserIconView和FileChooserListView类。

FileChooserIconView 和 FileChooserListView 类提供非常易于使用的组件，它们以两种不同的视觉表示方式提供对文件系统的访问，正如其名称所示。

FileChooserListView 组件以垂直列表中文本项的形式显示文件和文件夹。文件夹左侧用“>”符号标识，单击可以展开或折叠其文件和子文件夹。

FileChooserIconView 组件显示文件夹图标及其名称，以及文件图标及其名称。

如果文件/文件夹数量超过组件的高度和宽度，则会附加垂直和水平滚动条。

FileChooser 视图具有以下属性：

• files - 应用过滤器后，路径指定的目录中的文件列表。files 是一个只读 ListProperty。

• filter_dirs - 指示过滤器是否也应应用于目录。filter_dirs 是一个 BooleanProperty，默认为 False。

• filters - filters 指定要应用于目录中文件的过滤器。filters 是一个 ListProperty，默认为 []。如果为空，则等效于 '*'，表示没有文件被过滤掉。路径更改时，过滤器不会重置。如果需要，您需要自己重置。

您可以在列表中指定一个或多个以下模式：

这两个视图都会引发 on_selection 事件，可以将回调绑定到该事件。当生成此事件时，如果选择了文件夹，它将展开或折叠该文件夹。如果选择了文件，则其名称将传递给回调。

ListView 示例

在第一个示例中，我们使用 FileChhoserListView 组件和标签在垂直框布局中构造 App 窗口。

为此目的，请使用以下“kv”文件脚本。select() 方法绑定到视图的“on_selection”事件。

<Filechooser>:
   label: label
   orientation: 'vertical'
   BoxLayout:
      FileChooserListView:
         canvas.before:
            Color:
               rgb: .4, .5, .5
            Rectangle:
               pos: self.pos
               size: self.size
         on_selection: root.select(*args)

   Label:
      id: label
      size_hint_y: .1
      canvas.before:
         Color:
            rgb: .5, .5, .4
         Rectangle:
            pos: self.pos
            size: self.size

请注意 FileChooseListView 和 Label 组件的 canvas 对象的使用，以提供背景颜色。

Kivy 应用类代码如下：

from kivy.app import App
from kivy.uix.boxlayout import BoxLayout
from kivy.core.window import Window

Window.size = (720,400)

class Filechooser(BoxLayout):
   def select(self, *args):
      try: self.label.text = args[1][0]
      except: pass
      
class FileDemoApp(App):
   def build(self):
      return Filechooser()
if __name__ == '__main__':
   FileDemoApp().run()

输出

运行上述代码后，您将获得文件/文件夹列表。文件及其完整路径的名称将显示在标签上。

IconView 示例

现在我们展示 FileChooserIconView 的用法。它与 Image 组件一起放置在一个水平框中。虽然 FileChooserIconView 的大部分配置与之前的示例相同，但我们添加了 filters 属性以将文件的显示限制为仅 png 文件。

<Filechooser>:
   img: img
   orientation: 'horizontal'
   BoxLayout:
      FileChooserIconView:
      filters: ['*.png']
         canvas.before:
            Color:
               rgb: .5, .4, .5
            Rectangle:
               pos: self.pos
               size: self.size
         on_selection: root.select(*args)
   
   Image:
      id: img
      source:""

由于我们打算显示选定的图像，因此更改了 select() 方法，以便 Image 对象的 source 属性被分配选定的文件。

class Filechooser(BoxLayout):
   def select(self, *args):
      try:
         self.img.source = args[1][0]
      except:
         print ('error')
         
class FileIconApp(App):
   def build(self):
      return Filechooser()

# run the App
if __name__ == '__main__':
   FileIconApp().run()

输出

运行程序并浏览到所需的图像文件。选定的图像将显示在右侧。