NAME

       XmDataField — The DataField widget class

SYNOPSIS

       #include <Xm/DataF.h>

DESCRIPTION

       The  DataField  widget is a Data Presentation widget that handles display and entry of data as text.  The
       DataField widget is a subclass of the  XmTextField  widget  intended  for  data  entry  applications.  In
       addition to all of the normal XmTextField functionality, it supports regular expression-based parsing and
       acceptance/rejection of its input through the XmNpicture resource, and right  justification  through  the
       XmNalignment resource.

       The  DataField  widget  provides  added capability by supporting several types of validation: a DataField
       widget containing an invalid value will not give-up focus; the user must enter  a  correct  value  before
       proceeding to another field.

   Classes
       DataField inherits behavior, resources, and traits from Core, XmPrimitive, and XmTextField.

       The class pointer is xmDataFieldWidgetClass.

       The class name is XmDataField.

   New Resources
       The  following  table  defines  a  set  of  widget  resources used by the programmer to specify data. The
       programmer can also set the resource values for the inherited classes to set attributes for this  widget.
       To  reference  a  resource by name or by class in a .Xdefaults file, remove the XmN or XmC prefix and use
       the remaining letters.  To specify one of the defined values for a resource in a .Xdefaults file,  remove
       the  Xm  prefix  and  use  the  remaining  letters  (in  either  lowercase  or uppercase, but include any
       underscores between words). The codes in the access column indicate if the given resource can be  set  at
       creation time (C), set by using XtSetValues (S), retrieved by using XtGetValues (G), or is not applicable
       (N/A).

       ┌─────────────────────────────────────────────────────────────────────────────────────────┐
--

Callback Routines

       A pointer to the following structure is passed to the list of routines for the XmNvalidateCallback:
       typedef struct _XmDataFieldCallbackStruct {
                                     Widget   w;       /* The XmDataField */
                                     String   text;    /* Proposed string */
                                     Boolean  accept;  /* Accept return value, for validation */
       } XmDataFieldCallbackStruct;

RELATED

       Core(3),   XmCreateDataField(3),   XmPrimitive(3),  XmTextFieldSetString(3),  XmTextFieldSetStringWcs(3),
       XmVaCreateDataField(3), and XmVaCreateManagedDataField(3).

VERSION

       This manual page documents the XmDataField widget shipped in Motif version 2.2

AUTHOR

       (c) 2002 by Integrated Computer Solutions, Inc.

       Edited by Kevin Cook.

                                                                                                  XmDataField(3)