XmStringComponentCreate()



     XmStringComponentCreate(3XUNIX System XmStringComponentCreate(3X)



     NAME
          XmStringComponentCreate - A compound string function that
          creates arbitrary components

     SYNOPSIS
          #include <Xm/Xm.h>
          XmString XmStringComponentCreate(
          XmStringComponentType ctype,
          unsigned int length,
          XtPointer value);

     VERSION
          This page documents Motif 2.1.

     DESCRIPTION
          XmStringComponentCreate creates a new XmString component of
          type c_type, containing value. If value is invalid for the
          particular component type, this function fails and returns
          NULL.

          c_type    Specifies the type of component to be created.

          length    Specifies the length in bytes of value.  Note that
                    this must be precisely the length of the
                    valuestring, not including any trailing null
                    characters.

          value     Specifies the value to be used in the creation of
                    the component.

          Refer to the XmStringComponentType(3) reference page for a
          list of the possible XmString component types.

     RETURN
          If value is invalid for c_type, fails and returns NULL.
          Otherwise, this function returns a new compound string.
          When the application no longer needs the returned compound
          string, the application should call XmStringFree.

     RELATED
          XmString(3), XmStringGetNextTriple, XmStringComponentType,
          and XmStringFree(3).













     Page 1                                          (printed 1/22/99)
Museum
