| Value | Meaning |
|---|---|
| NORMAL1 | This is the default mode that gtk.PlacesSidebar uses if no other flags are specified. It indicates that the calling application should open the selected location in the normal way, for example, in the folder view beside the sidebar. |
| NEW_TAB2 | When passed to PlacesSidebar.setOpenFlags, this indicates that the application can open folders selected from the sidebar in new tabs. This value will be passed to the open-location signal when the user selects that a location be opened in a new tab instead of in the standard fashion. |
| NEW_WINDOW4 | Similar to GTK_PLACES_OPEN_NEW_TAB, but indicates that the application can open folders in new windows. |
These flags serve two purposes. First, the application can call PlacesSidebar.setOpenFlags using these flags as a bitmask. This tells the sidebar that the application is able to open folders selected from the sidebar in various ways, for example, in new tabs or in new windows in addition to the normal mode.
Second, when one of these values gets passed back to the application in the open-location signal, it means that the application should open the selected location in the normal way, in a new tab, or in a new window. The sidebar takes care of determining the desired way to open the location, based on the modifier keys that the user is pressing at the time the selection is made.
If the application never calls PlacesSidebar.setOpenFlags, then the sidebar will only use GTK_PLACES_OPEN_NORMAL in the open-location signal. This is the default mode of operation.