Gsearch

Gsearch
←	Chapter 5. Dialog Templates	→

Name

gsearch — Create and manipulate gsearch windows

Synopsis

          package require gsearch

          gsearch pathName ?options ?

Runtime Library Options

-creator

The RTL based option creator is used to instantiate the template gsearch with a Tk Window. The used creator window must have a -class property.

Acceptable Tk Windows are: toplevel for floating windows, and frame for embedded windows.

Standard Options

-background, -relief, -foreground, -highlightBackground, -highlightColor, -highlightThickness, -height, -width, -borderWidth, -exportSelection, -setGrid, -state: See the options manual entry for details on the standard options.

Window-specific Options

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

Defines the command to be executed for every selection.

Example 5.1. Default setting for selectfcn

gsearch .gsearch -selecfcn  \
   "search-selectfcn %s %s";

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.

Description

Figure 5.1. gsearch