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)