[ Tklib Table Of Contents | Tklib Index ]
widget_listsimple(n) 0.1 "widget::listsimple widget"
Name
widget_listsimple - widget::listsimple widget
Synopsis
- package require Tcl 8.5
- package require Tk 8.5
- package require widget::listsimple ?0.1?
- package require widget::validator ?0.1?
- package require widget::scrolledwindow
- package require snit
- package require tooltip
- package require img::png
- package require msgcat
Description
This package provides a megawidget for the interactive entry of unordered lists. For a megawidget allowing the entry of ordered lists, and more, please see the package widget::listentry.
Class API
The widget class supports a single command, for the creation of widgets.
- widget::listsimple pathname ?options?
-
This command creates and configures new instances of the widget.
For details on the available options please see section Widget Options.
The result of the command is the pathname of the new widget.
Instance API
All widget instances supported the following methods.
- widgetCmd destroy
-
This method destroys the widget. Any further access to the widget will generate errors.
The result of the command is the empty string.
- widgetCmd configure
-
This method comes in three variants. This variant here returns a list containing the current configuration of the widget, i.e. the values for all options.
For details on the available options please see section Widget Options.
- widgetCmd configure option value ...
-
This method comes in three variants. This variant here reconfigures the widget, setting the specified options to the given values.
Note that it is not possible to change the construction-time only options.
For details on the available options please see section Widget General Options.
The result of the command is the empty string.
- widgetCmd configure option
-
This method comes in three variants. This variant here is an alias for the method cget below and identical to it.
- widgetCmd cget option
-
This method returns the current value of the specified option.
For details on the available options please see section Widget Options.
Widget Options
This section explains all the options available to instances of widget::listsimple. Please note that a few of the options can be set only at instance construction time. The majority of the options can however be set both during construction- and runtime.
Bugs, Ideas, Feedback
This document, and the package it describes, will undoubtedly contain bugs and other problems. Please report such in the category widget::listsimple of the Tklib Trackers. Please also report any ideas for enhancements you may have for either package and/or documentation.
Keywords
data entry lists, data entry set of strings, data entry unordered list, list entry panel, set entry panel, widget