Manual Pages for UNIX Operating System command usage for man m_setvalues_layout

Layout Service Library Functions      m_setvalues_layout(3LAYOUT)



NAME
     m_setvalues_layout - set layout values of a LayoutObject

SYNOPSIS
     cc [ flag... ] file... -llayout [ library... ]
     #include 

     int m_setvalues_layout(LayoutObject layout_object,
          const LayoutValues values, int *index_returned);


DESCRIPTION
     The m_setvalues_layout() function changes the layout  values
     of a LayoutObject.


     The layout_object argument specifies a LayoutObject returned
     by the m_create_layout(3LAYOUT) function.


     The values argument specifies the list of layout values that
     are to be changed. The values are written into the LayoutOb-
     ject and may affect the behavior of subsequent layout  func-
     tions.   Some  layout  values do alter internal states main-
     tained by a LayoutObject.


     The m_setvalues_layout() function can be  implemented  as  a
     macro that evaluates the first argument twice.

RETURN VALUES
     Upon successful completion, the requested layout values  are
     set and 0 is returned. Otherwise -1 is returned and errno is
     set to indicate the error. If any value cannot be set,  none
     of  the layout values are changed and the (zero-based) index
     of  the  first  value  causing  the  error  is  returned  in
     index_returned.

ERRORS
     The m_setvalues_layout() function may fail if:

     EINVAL    The layout value specified  by  index_returned  is
               unknown,    its   value   is   invalid,   or   the
               layout_object argument is invalid.


     EMFILE    There are {OPEN_MAX}  file  descriptors  currently
               open in the calling process.


USAGE




SunOS 5.11           Last change: 7 Aug 2006                    1






Layout Service Library Functions      m_setvalues_layout(3LAYOUT)



     Do not use expressions  with  side  effects  such  as  auto-
     increment or auto-decrement within the first argument to the
     m_setvalues_layout() function.

ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Interface Stability         | Committed                   |
    |_____________________________|_____________________________|
    | MT-Level                    | MT-Safe                     |
    |_____________________________|_____________________________|
    | Standard                    | See standards(5).           |
    |_____________________________|_____________________________|


SEE ALSO
     m_create_layout(3LAYOUT), attributes(5), standards(5)
































SunOS 5.11           Last change: 7 Aug 2006                    2