python核心编程学习笔记-2016-09-03-02-图形化用户界面编程（三）

        19.3.6中级Tkinter范例

         这个程序比较复杂，其中有部分内容还没有完全理解。

#-*-coding: utf-8-*-

import os
from time import sleep
from Tkinter import *

class DirList(object):

def __init__(self, initdir=None):
# 第一个标签：self.label，就是Directory Lister v1.1
self.top = Tk()
self.label = Label(self.top, text='Directory Lister v1.1')
self.label.pack()

# 第二个标签：self.dirl，就是当前文件目录路径
self.cwd = StringVar(self.top) # cwd是Tk()变量，用来跟踪当前所在目录的名字，以字符串形式？现在并没有将值传入
self.dirl = Label(self.top, fg='blue', font=('Helvetica', 12, 'bold'))
self.dirl.pack()

# 定义整个GUI程序核心，即主体部分，用框架（包含列表框和滚动条）这一组件形式表现
self.dirfm = Frame(self.top) # 框架组件，纯容器，包含其他组件
self.dirsb = Scrollbar(self.dirfm) # 滚动条，在这里是对列表框提供滚动功能
self.dirsb.pack(side=RIGHT, fill=Y) # 将列表框放置在右侧，并且填满竖直方向
self.dirs = Listbox(self.dirfm, height=15, width=50, yscrollcommand=self.dirsb.set) # 列表框，参数依次是父组件、高度、宽度以及竖直方向滚动命令，其中竖直方向滚动命令就设置为滚动条
self.dirs.bind('<Double-1>', self.setDirAndGo) # 绑定回调函数setDirAndGo，但是'<Double-1>'是指鼠标双击列表框中的任意一项内容时，调用回调函数setDirAndGo()
self.dirsb.config(command=self.dirs.yview) # 表示滚动条对列表框进行竖直方向的滚动
self.dirs.pack(side=LEFT, fill=BOTH) # 列表框放置在左侧，并填满框架的剩余空间(BOTH)
self.dirfm.pack()

# 定义输入框，收集键盘输入
self.dirn = Entry(self.top, width=50, textvariable=self.cwd) # textvariable参数是指输入的内容，在本例中是输入文件目录，默认值是当前文件目录
self.dirn.bind('<Return>', self.doLS) # 绑定回调函数doLS，但是'<Return>'是指用户在输入框输完文本后，按下回车键，就会调用函数doLS()
self.dirn.pack()

# 定义按钮框架，包含三个按钮
self.bfm = Frame(self.top)
self.clr = Button(self.bfm, text='Clear', command=self.clrDir, activeforeground='white', activebackground='blue') # "clear"按钮，回调函数是清楚所有文件clrDir()
self.ls = Button(self.bfm, text='List Directory', command=self.doLS, activeforeground='white', activebackground='green') # "go"按钮，回调函数是doLS()
self.quit = Button(self.bfm, text='Quit', command=self.top.quit, activeforeground='white', activebackground='red') # 退出按钮
self.clr.pack(side=LEFT)
self.ls.pack(side=LEFT)
self.quit.pack(side=LEFT)
self.bfm.pack()

# 初始化GUI程序，从当前目录开始，不理解。
if initdir:
self.cwd.set(os.curdir)
self.doLS()

# clr按钮的回调函数，清空Tk字符串变量cwd
def clrDir(self, ev=None):
self.cwd.set('')

# 列表框回调函数，设置了要达到的目录，以及调用doLS()函数
def setDirAndGo(self, ev=None):
check = self.dirs.get(self.dirs.curselection()) # 列表框的get()方法是得到列表中的所有值(未传入参数)，在传入参数（行号）的情况下是获得所选中的选项；curselection()是返回选中的元素的行号
if not check:
check = os.curdir
self.cwd.set(check) # 将cwd跟踪至列表框中某项目录
self.doLS()

# 整个GUI程序的关键，负责安全检查，若无问题，则调用os.listdir()取得新文件集合，并替换列表框列表
def doLS(self, ev=None):
# 安全检查
error = ''
tdir = self.cwd.get() # 以字符串形式返回cwd追踪目录
if not tdir: tdir = os.curdir # 若为空，则tdir设为当前目录

if not os.path.exists(tdir): # 文件不存在
error = tdir + ': no such file'
elif not os.path.isdir(tdir): # 文件路径不存在
error = tdir + ': not a directory'

# 若有错误，则最终目录设置为当前目录
if error:
self.cwd.set(error) # 将cwd设为error
self.top.update() # ？？？
sleep(2)
if not (hasattr(self, 'last') and self.last):
self.last = os.curdir
self.cwd.set(self.last) # 重新设置cwd为当前目录
self.dirs.config(selectbackground='LightSkyBlue')
self.top.update() # ？？？
return

self.cwd.set('FETCHING DIRECTORY CONTENTS...')
self.top.update()
dirlist = os.listdir(tdir) # 列出文件目录tdir下所有文件
dirlist.sort() # 排序
os.chdir(tdir) # 将当前工作目录设置为tdir
self.dirl.config(text=os.getcwd()) # 配置，将第二个标签内容定为当前工作目录
self.dirs.delete(0, END) # 删除旧目录下列表框的内容
self.dirs.insert(END, os.curdir) # 在新目录列表框的最后加入当前目录
self.dirs.insert(END, os.pardir) # 在新目录列表框的最后加入当前目录的上一级目录
for eachFile in dirlist: # 在新目录的列表框中，加入新目录下的所有文件
self.dirs.insert(END, eachFile)
self.cwd.set(os.curdir)
self.dirs.config(selectbackground='LightSkyBlue')

def main():
d = DirList(os.curdir)
mainloop()

if __name__ == "__main__":
main()

        针对self.cwd这个变量，本人理解是，它决定着第二个标签的文本内容，有点类似于指针，默认值是当前工作目录。但输入框和列表框都能影响它的值。

        首先是输入框，用户输入文本内容后，先检查用户输入，若无问题，则将self.cwd设为用户输入的字符串，随之列表框内容也发生相应的改变。其次是在用户点击列表框的某一项时，self.cwd也会变为相应的目录，等同于在输入框输入一个相同的字符串。