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)