* library/entry.tcl: Adjusted Button-1 binding to set focus to the

entry when it is readonly or normal.

* doc/entry.n: Added documentation for readonly state,
-disabledforeground, -disabledbackground.

* tests/entry.test: Added tests for readonly state.

* generic/tkEntry.c: Added support for "readonly" state, and
redefined "disabled" state.  A disabled entry will display its
text in a dimmed color and possibly with a different background,
and will be completely unusable (no selection, no editing).  A
readonly entry will look like a normal entry, but it will not be
editable; selection is still allowed. [RFE: 4239].  To support the
new disabled state properly, "-disabledforeground" and
"-disabledbackground" options were added.
*** THIS IS A BACKWARDS INCOMPATIBLE BEHAVIOR CHANGE ***

* win/tkWinDefault.h:
* mac/tkMacDefault.h:
* unix/tkUnixDefault.h: Added DEF_ENTRY_DISABLED_FG,
DEF_ENTRY_DISABLED_BG_COLOR, DEF_ENTRY_DISABLED_BG_MONO.


FossilOrigin-Name: 1e58446d8a212f90f788f6cd0965f9cbb2d1e606

1 files changed, 28 insertions, 11 deletions

diff --git a/doc/entry.n b/doc/entry.n
index ee76524..474e2a2 100644
--- a/doc/entry.n
+++ b/doc/entry.n
@@ -6,7 +6,7 @@
 '\" See the file "license.terms" for information on usage and redistribution
 '\" of this file, and for a DISCLAIMER OF ALL WARRANTIES.
 '\" 
-'\" RCS: @(#) $Id: entry.n,v 1.4 2000/03/02 21:53:01 hobbs Exp $
+'\" RCS: @(#) $Id: entry.n,v 1.5 2000/05/14 20:45:37 ericm Exp $
 '\" 
 .so man.macros
 .TH entry n 8.3 Tk "Tk Built-In Commands"
@@ -17,14 +17,24 @@ entry \- Create and manipulate entry widgets
 .SH SYNOPSIS
 \fBentry\fR \fIpathName \fR?\fIoptions\fR?
 .SO
-\-background	\-highlightbackground	\-insertontime	\-selectforeground
-\-borderwidth	\-highlightcolor	\-insertwidth	\-takefocus
-\-cursor	\-highlightthickness	\-justify	\-textvariable
-\-exportselection	\-insertbackground	\-relief	\-xscrollcommand
-\-font	\-insertborderwidth	\-selectbackground
-\-foreground	\-insertofftime	\-selectborderwidth
+\-background             \-highlightthickness     \-selectbackground
+\-borderwidth            \-insertbackground       \-selectborderwidth
+\-cursor                 \-insertborderwidth      \-selectforeground
+\-exportselection        \-insertofftime          \-takefocus
+\-font                   \-insertontime           \-textvariable
+\-foreground             \-insertwidth            \-xscrollcommand
+\-highlightbackground    \-justify                
+\-highlightcolor         \-relief
 .SE
 .SH "WIDGET-SPECIFIC OPTIONS"
+.VS 8.4
+.OP \-disabledbackground disabledBackground DisabledBackground
+Specifies the background color to use when the entry is disabled.  If
+this option is the empty string, the normal background color is used.
+.OP \-disabledforeground disabledForeground DisabledForeground
+Specifies the foreground color to use when the entry is disabled.  If
+this option is the empty string, the normal foreground color is used.
+.VE 8.4
 .VS 8.3
 .OP "\-invalidcommand or \-invcmd" invalidCommand InvalidCommand
 Specifies a script to eval when \fBvalidateCommand\fR returns 0.
@@ -42,11 +52,18 @@ a password.
 If characters in the entry are selected and copied elsewhere, the
 information copied will be what is displayed, not the true contents
 of the entry.
+.VS 8.4
 .OP \-state state State
-Specifies one of two states for the entry:  \fBnormal\fR or \fBdisabled\fR.
-If the entry is disabled then the value may not be changed using widget
-commands and no insertion cursor will be displayed, even if the input focus is
-in the widget.
+Specifies one of three states for the entry:  \fBnormal\fR,
+\fBdisabled\fR, or \fBreadonly\fR.  If the entry is readonly, then the
+value may not be changed using widget commands and no insertion cursor
+will be displayed, even if the input focus is in the widget; the
+contents of the widget may still be selected.  If the entry is
+disabled, the value may not be changed, no insertion cursor will be
+displayed, the contents will not be selectable, and the entry may
+be displayed in a different color, depending on the values of the
+\fB-disabledforeground\fR and \fB-disabledbackground\fR options.
+.VE 8.4
 .VS 8.3
 .OP \-validate validate Validate
 Specifies the mode in which validation should operate: \fBnone\fR,