QFileSystemModel中setRootPath与setRootIndex的区别是什么？

Hey there! I totally get the confusion when first working with QFileSystemModel—these two methods sound almost identical but serve completely distinct roles. Let me break them down with practical examples so you can wrap your head around it:

1. setRootPath: Defines the Model's Monitoring Scope #

This is a model-level setting. When you call setRootPath() on your QFileSystemModel, you're telling the model which directory it should start monitoring for file system changes (like new files, deleted folders, renames).

• It doesn't change what your view (e.g., QTreeView, QListView) displays—your view will still show the system's root (like "This PC" on Windows, or "/" on Linux) by default.
• The model will track all changes under the path you specify, even if those changes are in subdirectories.
• Example code:

  QFileSystemModel *model = new QFileSystemModel;
  // Tell the model to monitor changes starting from the Users directory
  model->setRootPath("C:/Users");
  

  In this case, the model will watch for any changes in C:/Users and all its subfolders, but a QTreeView attached to this model will still start showing the entire system hierarchy unless you adjust the view's root.

2. setRootIndex: Sets the View's Display Root #

This is a view-level setting. setRootIndex() tells your view which specific directory it should use as its starting point for displaying content.

• To use it, you first need to get the QModelIndex corresponding to your target directory using the model's index() method.
• Once set, the view will only show the contents of that directory (and its subdirectories) — users won't see the parent directories above it in the view.
• Example code:

  QTreeView *view = new QTreeView;
  view->setModel(model);
  // Get the index for the "Me" folder under Users
  QModelIndex userFolderIndex = model->index("C:/Users/Me");
  // Tell the view to start displaying from this folder
  view->setRootIndex(userFolderIndex);
  

  Now the view will only show the contents of C:/Users/Me, hiding the rest of the file system hierarchy above it.

Key Takeaways to Avoid Confusion #

• setRootPath → Configures what the model watches (data source scope). It's about the model's internal behavior.
• setRootIndex → Configures what the view shows (display starting point). It's about how the data is presented to the user.
• Pro tip: Even though setRootPath() returns a QModelIndex, it's better practice to use model->index(targetPath) to get the index for setRootIndex()—this makes your code clearer and avoids unexpected behavior.

内容的提问来源于stack exchange，提问作者X-Black...