Window-specific Options

Command-Line Name: -selectfcn, Database Name: selectfcn, Database Class: -

Defines the command to be executed for every selection.

Command-Line Name: -expression, Database Name: expression, Database Class; -

The used regular expression, see re_syntax for details on regular expressions.

Command-Line Name: -method, Database Name: method, Database Class; -

Defines what search »method« will be used.

Possible values are:

name, parent, class, containing, toplevel, manager, rootx, rooty, atomname, cells, ismapped, screen, screencells, viewable, visualid, atom, x, y, id, background, foreground, selectcolor, troughcolor, selectbackground, selectforeground, insertbackground, insertforeground, highlightcolor, highlightbackground, activebackground, activeforeground, clientbackground, disabledforeground, disabledbackground, readonlybackground, gridcolor, font, text, label, title, image, iconfont, token, href, help, wrap, wraplength, aspect, justify, selectimage, headerfont, menu, width, height, borderwidth, highlightthickness, elementborderwidth, activeborderwidth, selectborderwidth, insertborderwidht, scrollwidth, relief, menu, takefocus, tearoff, indicatoron, cursor, accelerator, pad, iborderwidth, irelief, setgrid, insertwidth, direction, command, variable, onvalue, offvalue, textvariable, value, exportselection, orient, listvariable, selectmode, state, default, activestyle, validate, validatecommand, invalidcommand, gridsize, hidetitle, ensure, require, show, undo, package, hidecommand, vectorsize, sides, type, sort, widget, offset, taboffset, bitmap, anchor, underline, compound, activerelief, padx, pady.

Command-Line Name: -activeStyle, Database Name: activeStyle, Database Class; ActiveStyle

Specifies the style in which to draw the active element. This must be one of dotbox (show a focus ring around the active element), none (nospecial indication of active element) or underline (underline the active element). The default is underline.

Command-Line Name: -selectmode, Database Name: selectMode, Database Class; SelectMode

Specifies one of several styles for manipulating the selection. The value of the option may be arbitrary, but the default bindings expect it to be either single, browse, multiple, or extended; the default value is browse.


Figure 5.1. gsearch

The »gsearch« command creates a gsearch window.

The »gsearch« dialog is used to search for the value for a specific window property.

The various used search methods are defined through vgfind.tcl; there is also an access method defined inside of gsearch.tcl: search-selectfcn, this procedure is the default search call back.

The search is conducted as a conventional regular expression. Successive searches are also possible, but are not yet recorded.

Window Command

A Window created through the gsearch command exposes various functions. Using these functions has the following general form:

          pathName option ?arg arg ...?

PathName is the same as the window path name. Option and the args determine the exact behavior of the command. The following commands are possible for this window:

pathName cget option

Returns the current value of the configuration option given by option. Option may have any of the values accepted by the gsearch command.

pathName configure ?option? ?value option value ...?

Query or modify the configuration options of the window. If no option is specified, returns a list describing all of the available options for pathName (see Tk_ConfigureInfo for information on the format of this list). If option is specified with no value, then the command returns a list describing the one named option (this list will be identical to the corresponding sublist of the value returned if no option is specified). If one or more option-value pairs are specified, then the command modifies the given window option(s) to have the given value(s); in this case the command returns an empty string. Option may have any of the values accepted by the gsearch command.

pathName select

Call the callback procedure for each select operation. Taken from vgsearchifc.tcl,

Author : Arndt Roger Schneider mail-to :

Written : 1998, Roger Revision : 06/06/2008, Roger --cleansed »var« Copyright © 2005-2008 Arndt Roger Schneider Copyright © 1998-1999 Patzschke + Rasp GmbH 1999 Patzschke + Rasp Software AG

pathName find

Search for all windows featuring the property denoted by the searchmethod.

Rewritten : 05/21/2008, Roger

pathName init

Rewritten : 03/18/2008, Roger

pathName repeate

Use the previous result, and repeat with another expression. Taken from vgsearchifc.tcl,

Author : Arndt Roger Schneider Mail-to : Written : 1998, Roger Copyright © 2005-2008 Arndt Roger Schneider Copyright © 1998-1999 Patzschke + Rasp GmbH 1999 Patzschke + Rasp Software AG License: Artistic License

pathName selectall ?items?

Select every element inside the listbox. Rewritten : 11/12/2007, Roger