From 5601295b75f82401817b35387a9843a18a9ae357 Mon Sep 17 00:00:00 2001 From: "Martin M. Hunt" Date: Tue, 21 Jan 2003 20:42:51 +0000 Subject: imported itcl 3.2.1 --- itcl/iwidgets/demos/html/finddialog.n.html | 392 +++++++++++++++++++++++++++++ 1 file changed, 392 insertions(+) create mode 100644 itcl/iwidgets/demos/html/finddialog.n.html (limited to 'itcl/iwidgets/demos/html/finddialog.n.html') diff --git a/itcl/iwidgets/demos/html/finddialog.n.html b/itcl/iwidgets/demos/html/finddialog.n.html new file mode 100644 index 00000000000..6c578972bdb --- /dev/null +++ b/itcl/iwidgets/demos/html/finddialog.n.html @@ -0,0 +1,392 @@ +finddialog - Create and manipulate a find dialog widget +

finddialog - Create and manipulate a find dialog widget

+ +

SYNOPSIS

+finddialog pathName ?options? +

INHERITANCE

+itk::Toplevel <- Shell <- Dialogshell <- Finddialog +

STANDARD OPTIONS

+

+ + + + + +
+activeBackground
+cursor
+highlightColor
+insertOffTime
+selectBorderWidth
+		 +activeForeground
+disabledForeground
+highlightThickness
+insertOnTime
+selectColor
+		 +background
+font
+insertBackground
+insertWidth
+selectForeground
+		 +borderWidth
+foreground
+insertBorderWidth
+selectBackground
+
+

+See the "options" manual entry for details on the standard options. +

ASSOCIATED OPTIONS

+

+ + + + + +
+selectColor
+		 + + +
+

+See the "checkbutton" widget manual entry for details on the above +associated options. +

+ + + + + +
+selectColor
+		 + + +
+

+See the "entryfield" widget manual entry for details on the above +associated options. +

+ + + + + +
+labelFont
+		 + + +
+

+See the "labeledwidget" widget manual entry for details on the above +associated options. +

INHERITED OPTIONS

+

+ + + + + +
+buttonBoxPadX
+padY
+		 +buttonBoxPadY
+separator
+		 +buttonBoxPos
+thickness
+		 +padX
+
+

+See the "dialogshell" widget manual entry for details on the above +inherited options. +

+ + + + + +
+height
+		 +master
+		 +modality
+		 +width
+
+

+See the "shell" widget manual entry for details on the above +inherited options. +

+ + + + + +
+title
+		 + + +
+

+See the "Toplevel" widget manual entry for details on the above +inherited options. +

WIDGET-SPECIFIC OPTIONS

+

+

+Name:                   clearCommand
+Class:                  Command
+Command-Line Switch:	-clearcommand
+
+
    +Specifies a command to be invoked following a clear operation. +The option is meant to be used as means of notification that the +clear has taken place and allow other actions to take place such +as disabling a find again menu. +
+

+

+Name:                   matchCommand
+Class:                  Command
+Command-Line Switch:	-matchcommand
+
+
    +Specifies a command to be invoked following a find operation. +The command is called with a match point as an argument which identifies +where exactly where in the text or scrolledtext widget that the match +is located. Should a match not be found the match point is {}. The +option is meant to be used as a means of notification that the +find operation has completed and allow other actions to take place +such as disabling a find again menu option if the match point was {}. +
+

+

+Name:                   patternBackground
+Class:                  Background
+Command-Line Switch:	-patternbackground
+
+
    +Specifies the background color of the text matching the search +pattern. It may have any of the forms accepted by Tk_GetColor. +The default is gray44. +
+

+

+Name:                   patternForeground
+Class:                  Background
+Command-Line Switch:	-patternforeground
+
+
    +Specifies the foreground color of the text matching the search +pattern. It may have any of the forms accepted by Tk_GetColor. +The default is white. +
+

+

+Name:                   searchBackground
+Class:                  Background
+Command-Line Switch:	-searchbackground
+
+
    +Specifies the background color of the line containing the matching +the search pattern. It may have any of the forms accepted by Tk_GetColor. +The default is gray77. +
+

+

+Name:                   searchForeground
+Class:                  Background
+Command-Line Switch:	-searchforeground
+
+
    +Specifies the foreground color of the line containing the matching +the search pattern. It may have any of the forms accepted by Tk_GetColor. +The default is black. +
+

+

+Name:                   textWidget
+Class:                  TextWidget
+Command-Line Switch:	-textwidget
+
+
    +Specifies the text or scrolledtext widget to be searched. +
+
+ +

DESCRIPTION

+

+The finddialog command creates a find dialog that works in +conjunction with a text or scrolledtext widget to provide a means +of performing search operations. The user is prompted for a text +pattern to be found in the text or scrolledtext widget. The +search can be for all occurances, by regular expression, considerate +of the case, or backwards. + +

METHODS

+

+The finddialog command creates a new Tcl command whose +name is pathName. This +command may be used to invoke various +operations on the widget. It has the following general form: +

+pathName option ?arg arg ...?
+
+Option and the args +determine the exact behavior of the command. The following +commands are possible for finddialog widgets: +

INHERITED METHODS

+

+ + + + + +
+add
+invoke
+		 +buttonconfigure
+show
+		 +default
+		 +hide
+
+

+See the "buttonbox" widget manual entry for details on the above +inherited methods. +

+ + + + + +
+activate
+		 +center
+		 +deactivate
+		 +
+

+See the "shell" widget manual entry for details on the above +inherited methods. +

WIDGET-SPECIFIC METHODS

+
+
pathName cget option + +
Returns the current value of the configuration option given +by option. +Option may have any of the values accepted by the finddialog +command. +
+
+
pathName clear + +
Clears the pattern in the entry field and the pattern matchin +indicators in the text or scrolledtext widget. +
+
+
pathName configure ?option? ?value option value ...? + +
Query or modify the configuration options of the widget. +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 widget 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 finddialog +command. +
+
+
pathName find + +
Search for a specific text string in the text widget given by +the -textwidget option. This method is the standard callback +for the Find button. It is made available such that it can be +bound to a find again action. + +
+

COMPONENTS

+

+

+Name:                   all
+Class:                  Checkbutton
+
+ +

+

+Name:                   backwards
+Class:                  Checkbutton
+
+ +

+

+Name:                   case
+Class:                  Checkbutton
+
+ +

+

+Name:                   pattern
+Class:                  Entryfield
+
+ +

+

+Name:                   regexp
+Class:                  Checkbutton
+
+ + + +

EXAMPLE

+
+ scrolledtext .st
+ pack .st
+ .st insert end "Now is the time for all good men\\n" 
+ .st insert end "to come to the aid of their country"
+
+ finddialog .fd -textwidget .st
+ .fd center .st
+ .fd activate
+
+

AUTHOR

+Mark L. Ulferts +

KEYWORDS

+finddialog, dialogshell, shell, widget + -- cgit v1.2.1