| Allegro CL version 6.2 Significantly revised from 6.1 | |||||||||
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 is typically the window in which the search will be done, though it can actually be an arbitrary window. 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-2002, Franz Inc. Oakland, CA., USA. All rights reserved.
Documentation for Allegro CL version 6.2. This page has had significant revisions compared to the 6.1 page.
Created 2002.2.26.
| Allegro CL version 6.2 Significantly revised from 6.1 | |||||||||