These two PopupMenu system commands are used to provide expanded search options:
$SRCHCOL
$SRCHALL
Both options pop up a standard Windows "Find" dialog in which you can type in the string to search for and check a couple of search related options. $SRCHCOL searches just the column that was right-clicked to bring up the context menu, while $SRCHALL searches all columns of the tree.
To add these search options globally, add the following to miame.ini:
SBR=XTREE_SRCH
The text for the corresponding automatically-added context menu items will be taken from the SBRMSG.xxx messages 026,004 and 026,005, defaulting to:
026,004,Search Column
026,005,Search All (^F)
Note that these search functions may conflict with editable cell validation since the interaction with the pop up function may trigger a cell validation exit before the function can be carried out. To avoid that scenario, XTREE may ignore the SBR=XTREE_SRCH directive in some cases. You may however force them to be enabled by using the explicit PopupMenu $SRCHxxx options. There is no danger of this resulting in two sets of search options in the menu, as the PopupMenu options will override/replace the corresponding MIAME.INI directives.
The concept here is the same as for the $EXP options. Any explicit definition of a PopupMenu command starting with $SRCH will disable the appending of the automatic options, allowing you to customize the search options on a tree-by-tree basis. You can also disable a globally enabled search by defining an option with the command "-$SRCH", e.g.
"PopupMenu=xxx,-$SRCH"
Comments
The search logic normally only matches at the start of each cell (not counting leading spaces). But if you select the "Whole Word only" option in the search dialog, it will match the whole word anywhere in the cell contents.
As currently implemented, the search operation selects the entire item that the match occurs on, and also makes that column the active one (i.e. depresses the column header button). It does not highlight the cell, out of concern for possible confusion and conflicts with various editable cell configurations.
History
2024 November A-Shell 7.0.1765: Support added for searching the first column of a Property Sheet.
2012 December, A-Shell 6.1.1326: Function added to A-Shell
