pop-up-find-dialog

Arguments: window-or-screen initial-string search-backwards-p match-exactly-p &key (allow-match-exactly t) (allow-search-backwards t)

Displays a modal dialog asking the user to specify a search string and a few options for doing a search for that string. This function does not do an actual search, and instead simply returns the values specified by the user in the dialog. It is then up to the application to perform a search in some application-defined way.

window-or-screen is typically the window in which the search will be done, though it can actually be an arbitrary window or nil. If nil, then the stream returned by selected-window-or-screen is used. It is used in two ways: (1) The modal dialog is positioned with respect to this window according to the usual internal call to position-utility-dialog, and (2) the top-level-window of window will be passed as the stream argument to pop-up-modal-dialog, to disable user gestures on that window and all of its other owned windows while the modal dialog is present.

initial-string should be a string to be displayed in the search-string widget when the dialog appears. Use the null string to cause the widget initially to be empty.

search-backwards-p determines whether the check-box on the dialog for requesting a backward search will be initially checked. If true, then the widget will be checked, and if nil it will not be.

match-exactly-p determines whether the check-box on the dialog for requesting an "exact match" will be initially checked. If true, then the widget will be checked, and if nil it will not be. This option is typically used to specify whether the search will be case-sensitive or case-insensitive.

allow-match-exactly determines whether the check-box on the dialog for requesting an "exact match" will be available so that the user may change its value. If true, then it will be available; if nil, then it will not be.

allow-search-backwards determines whether the check-box on the dialog for requesting a backward search will be available. If true, then it will be available; if nil, then it will not be.

Three values are returned when the user exits the dialog. If the user cancels the dialog, then these three values will all be nil. Otherwise the values will be (1) the string in the search-string widget, (2) the value of the search-backwards check-box (true or nil), and (3) the value of the match-exactly check-box (true or nil).

Copyright (c) 1998-2016, Franz Inc. Oakland, CA., USA. All rights reserved.
This page was not revised from the 8.1 page.
Created 2010.1.21.