# QFileSystemWatcher Class Reference ## [[QtCore](index.htm) module] 該QFileSystemWatcher類提供用于監視文件和目錄進行修改的接口。[More...](#details) 繼承[QObject](qobject.html)。 ### Methods * `__init__ (self, QObject?parent?=?None)` * `__init__ (self, QStringList?paths, QObject?parent?=?None)` * `addPath (self, QString?file)` * `addPaths (self, QStringList?files)` * `QStringList directories (self)` * `QStringList files (self)` * `removePath (self, QString?file)` * `removePaths (self, QStringList?files)` ### Qt Signals * `void directoryChanged (const QString&)` * `void fileChanged (const QString&)` * * * ## Detailed Description 該QFileSystemWatcher類提供用于監視文件和目錄進行修改的接口。 QFileSystemWatcher監控通過觀看指定的路徑列表的修改文件和目錄的文件系統。 Call [addPath](qfilesystemwatcher.html#addPath)（）來觀看特定的文件或目錄。多條路徑可以使用添加的[addPaths](qfilesystemwatcher.html#addPaths)（）函數。現有的路徑可以通過使用可移除的[removePath](qfilesystemwatcher.html#removePath)（）和[removePaths](qfilesystemwatcher.html#removePaths)（）函數。 QFileSystemWatcher檢查添加到它的每個路徑。已經添加到QFileSystemWatcher文件可以使用被訪問的[files](qfilesystemwatcher.html#files)（）函數，并使用目錄中的[directories](qfilesystemwatcher.html#directories)（）函數。 該[fileChanged](qfilesystemwatcher.html#fileChanged)當一個文件被修改，重命名或從磁盤刪除（ ）信號被發射。類似地，[directoryChanged](qfilesystemwatcher.html#directoryChanged)當一個目錄或其內容被修改或刪除（ ）信號被發射。需要注意的是QFileSystemWatcher停止監控的文件，一旦他們被改名或刪除的磁盤和目錄，一旦他們被從磁盤中刪除。 **Note:**在運行Linux內核沒有inotify的支持系統，包含看了路徑文件系統不能被卸載。 **Note:**Windows CE不支持目錄監視默認情況下，因為這取決于所安裝的文件系統驅動程序。 **Note:**監控文件和目錄的修改行為會消耗系統資源。這意味著有一個限度的文件和目錄的過程中可以同時監控數。在Mac OS X 10.4和所有的BSD變體，例如，打開的文件描述符是需要為每個監視的文件。一些系統在默認情況下打開的文件描述符的數量限制為256 。這意味著[addPath](qfilesystemwatcher.html#addPath)（）和[addPaths](qfilesystemwatcher.html#addPaths)（ ）會在你的進程試圖超過256個文件或目錄添加到文件系統監視器失敗。另外請注意，你的程序可能有其他文件描述符，除了為那些被監視文件的打開，而這些其他打開的描述符也算在總。的Mac OS X 10.5及以上版本使用不同的后端，并沒有從這個問題受到影響。 * * * ## Method Documentation ``` QFileSystemWatcher.__init__ (self, QObject?parent?=?None) ``` 該_parent_的說法，如果不是沒有，原因_self_通過Qt的，而不是PyQt的擁有。 構造一個新的文件系統觀察的對象與給定_parent_。 ``` QFileSystemWatcher.__init__ (self, QStringList?paths, QObject?parent?=?None) ``` 該_parent_的說法，如果不是沒有，原因_self_通過Qt的，而不是PyQt的擁有。 構造一個新的文件系統觀察的對象與給定_parent_它監視指定的_paths_列表。 ``` QFileSystemWatcher.addPath (self, QString?file) ``` 添加_path_該文件系統觀察，如果_path_存在。如果它不存在的路徑不被添加，或者如果它已經由文件系統觀察監測。 If _path_指定一個目錄，該[directoryChanged](qfilesystemwatcher.html#directoryChanged)（在）信號將被發射時_path_被修改或從磁盤中刪除，否則[fileChanged](qfilesystemwatcher.html#fileChanged)（）信號被發射時_path_被修改，重命名或刪除。 **Note:**有一個依賴于系統的限制，可以同時進行監視的文件和目錄的數目。如果已達到極限，_path_不會被添加到文件系統觀察，并警告信息將被打印到_stderr_。 **See also** [addPaths](qfilesystemwatcher.html#addPaths)（）和[removePath](qfilesystemwatcher.html#removePath)（ ） 。 ``` QFileSystemWatcher.addPaths (self, QStringList?files) ``` 將每個路徑_paths_該文件系統觀察。如果它們不存在，不會添加路徑，或者如果他們已經由文件系統觀察監測。 如果路徑指定一個目錄，[directoryChanged](qfilesystemwatcher.html#directoryChanged)（在）信號將在路徑從磁盤修改或刪除被發射，否則[fileChanged](qfilesystemwatcher.html#fileChanged)當路徑被修改，重命名或刪除（ ）信號被發射。 **Note:**有一個依賴于系統的限制，可以同時進行監視的文件和目錄的數目。如果已達到限制，多馀的_paths_不會被添加到文件系統觀察，并警告信息將被打印到_stderr_對于無法加入的每個路徑。 **See also** [addPath](qfilesystemwatcher.html#addPath)（）和[removePaths](qfilesystemwatcher.html#removePaths)（ ） 。 ``` QStringList QFileSystemWatcher.directories (self) ``` 返回的路徑列表到被監視的目錄。 **See also** [files](qfilesystemwatcher.html#files)（ ） 。 ``` QStringList QFileSystemWatcher.files (self) ``` 返回的路徑列表到被監視的文件。 **See also** [directories](qfilesystemwatcher.html#directories)（ ） 。 ``` QFileSystemWatcher.removePath (self, QString?file) ``` 刪除指定的_path_從文件系統觀察。 **See also** [removePaths](qfilesystemwatcher.html#removePaths)（）和[addPath](qfilesystemwatcher.html#addPath)（ ） 。 ``` QFileSystemWatcher.removePaths (self, QStringList?files) ``` 刪除指定的_paths_從文件系統觀察。 **See also** [removePath](qfilesystemwatcher.html#removePath)（）和[addPaths](qfilesystemwatcher.html#addPaths)（ ） 。 * * * ## Qt Signal Documentation ``` void directoryChanged (const QString&) ``` 這是該信號的默認超載。 當指定在一個目錄中這個信號被發射_path_，被修改（例如，當一個文件被添加，修改或刪除），或從磁盤上刪除。需要注意的是，如果有在很短的時間內一些變化，一些變化可能不會發出這個信號。然而，變化的序列中的最后變化總是會生成這個信號。 **See also** [fileChanged](qfilesystemwatcher.html#fileChanged)（ ） 。 ``` void fileChanged (const QString&) ``` 這是該信號的默認超載。 當指定的文件這個信號被發射_path_被修改，重命名或從磁盤中刪除。 **See also** [directoryChanged](qfilesystemwatcher.html#directoryChanged)（ ） 。