# Module Scientific.TkWidgets

# Submodules:

- Module Scientific.TkWidgets.TkPlotCanvas

- Module Scientific.TkWidgets.TkVisualizationCanvas

## Class FilenameEntry: Filename entry widget

Constructor: FilenameEntry(master, text, pattern, must_exist_flag=1)

master

  the master widget

text

  the label in front of the filename box

pattern

  the filename matching pattern that determines the file list in the file selection dialog

must_exists_flag

  allow only names of existing files

A FilenameEntry widget consists of three parts: an identifying label, a text entry field for the filename, and a button labelled `browse` which call a file selection dialog box for picking a file name.

Methods:

- get()

  Return the current filename. If must_exist_flag is true, verify that the name refers to an existing file. Otherwise an error message is displayed and a ValueError is raised.

## Class FloatEntry: An entry field for float numbers

Constructor: FloatEntry(master, text, initial=None, lower=None, upper=None)

master

  the master widget

text

  the label in front of the entry field

initial

  an optional initial value (default: blank field)

upper

  an optional upper limit for the value

lower

  an optional lower limit for the value

A FloatEntry widget consists of a label followed by a text entry field.

Methods:

- set(value)

  Set the value to value.

- get()

  Return the current value, verifying that it is a number and between the specified limits. Otherwise an error message is displayed and a ValueError is raised.

## Class IntEntry: An entry field for integer numbers

Constructor: IntEntry(master, text, initial=None, lower=None, upper=None)

master

  the master widget

text

  the label in front of the entry field

initial

  an optional initial value (default: blank field)

upper

  an optional upper limit for the value

lower

  an optional lower limit for the value

A IntEntry widget consists of a label followed by a text entry field.

Methods:

- get()

  Return the current value, verifying that it is an integer and between the specified limits. Otherwise an error message is displayed and a ValueError is raised.

## Class ButtonBar: A horizontal array of buttons

Constructor: ButtonBar(master, left_button_list, right_button_list)

master

  the master widget

left_button_list

  a list of (text, action) tuples specifying the buttons on the left-hand side of the button bar

right_button_list

  a list of (text, action) tuples specifying the buttons on the right-hand side of the button bar

## Class StatusBar: A status bar

Constructor: StatusBar(master)

master

  the master widget

A status bar can be used to inform the user about the status of an ongoing calculation. A message can be displayed with set() and removed with clear(). In both cases, the StatusBar object makes sure that the change takes place immediately. While a message is being displayed, the cursor form is changed to a watch.