getstring.3tk

Langue: en

Version: 0.1 (debian - 07/07/09)

Section: 3 (Bibliothèques de fonctions)


 

NAME

getstring - A string dialog

SYNOPSIS

package require Tcl 8.4

package require getstring ?0.1?

::getstring::tk_getString pathName variable text ?options?

 

 
 

DESCRIPTION

This package provides a dialog which consists of an Entry, OK, and Cancel buttons.
::getstring::tk_getString pathName variable text ?options?
Creates a dialog which prompts the user with text to input a text string. The contents of the entry are put in the variable upon closure of the dialog. The command returns a boolean indicating if the user pressed OK or not. If -geometry is not specified, the dialog is centered in its parent toplevel unless its parent is . in which case the dialog is centered in the screen. Options: -title -allowempty a boolean argument indicating if the dialog should accept an empty entry -entryoptions simply passes its arguments through to the entry widget. This is valuble for performing extra validation using the Entry widget validation hooks. -geometry specifies the geometry of the window

EXAMPLE

 
 package require getstring
 namespace import getstring::*
 
 if {[tk_getString .gs text "Feed me a string please:"]} {
     puts "user entered: $text"
 }
 
 
 

KEYWORDS

dialog, entry, string