Thank you Leo. Got it. I figured for lister="0x404c8" and tab="0x1404e4" (windows ID). Also, side="1" is for top or left pane, side="2" for right or bottom.
Now, I'm just not sure for active_tab="n" and tab_state="n" ?
Let's put it with this question. Scenario: I have one lister with two side and, in each side, two tabs. So, a total of four folders. How can I know which folder is currently active? By active, I mean the foreground folder that has the focus.
You might need to double each % character in the paths, depending on how the command is being executed. (Due to the Windows command line using % for environment variables.)
Apart from that, those paths should work fine, as long as the folder still exists. I checked here using a Command Prompt and was able to use them without problems, after doubling the % characters.
(Lister-Quick-Find-Results are automatically created temporary collections, which may be destroyed a while after they are not longer displayed anywhere.)
coll:// is used for File Collections which can also include ones made and populated by the user explicitly, as well as via Tools -> Find Files and similar. Unlike the quick search results, those collections exist until deleted or overwritten. "coll://Find Results" is the most common one, but collections can be created using arbitrary names.
Collections can also be nested within other collections.
Thank you for the additional info about Collections.
Now, if there are two Lister-Quick-Find-Results collections in dopus-list.txt, is there a way to retrieve the search criteria for each of them. This would allow me to distinguish the two listers in a menu of listers.
I think there is just one piece of information missing in this thread: what is active_tab? How is it different from tab_state ?
Just to tell you why I want to fully understand the content on this paths file: I'm thinking about adding a feature to FP that would re-create a "workspace" by reading the paths list in a saved file. It would open new lister(s) with the proper paths in each sides and tabs, as it was when the paths list was created. Can you confirm that this does not already exist as a feature I would not know in DOpus?
OK. Good to know. I'll develop a similar feature for non-DOpus users (re-opening a group of Explorer windows) but I will not put as much energy to duplicate something already existing in DOpus. Thanks for letting me know.
active_tab indicates the tab is active (visible) and tells you which file display it's in (1 = left/top, 2 = right/bottom). tab_state tells you if the tab is set to source (1), destination (2) or off (0).
active_lister="1" active lister
active_lister="0" other active lister(s)
active_tab="1" active tab (visible) in left/top side
active_tab="2" active tab (visible) in right/bottom side
lister="0x404c8" unique window ID (or handle) of the lister
side="1" left/top file list in the lister
side="2" right/bottom file list in the lister
tab="0x1404e4" unique window ID (or handle) of the tab
tab_state="1" selected tab, on the active side of the lister.
tab_state="2" selected tab, on the inactive side of a dual-display lister.
Tabs which are not visible (because another tab is selected on top of them) don't get a tab_state attribute at all.
tab_state="1" tab is set to source
tab_state="2" tab is set to destination
tab_state="0" tab is off