Section 3: library functions
XmTabListFree — A convenience function that frees the memory of a new tab list Synopsis #include <Xm/Xm.h> void XmTabListFree( XmTabList tablist); Description XmTabListFree recovers memory used by a tab list. In addition, this function frees all contained tabs. If the tablist is NULL, the function returns immediately. tablist Specifies the tab list to be freed….
XmTabListCopy — A convenience function that creates a new tab list from an existing list Synopsis #include <Xm/Xm.h> XmTabList XmTabListCopy( XmTabList tablist, int offset, Cardinal count); Description XmTabListCopy creates a new tab list consisting of a copy of a portion of the contents of the tablist argument. This function starts copying at the specified offset…
XmTabList — Data type for a tab list Synopsis #include <Xm/Xm.h> XmTabList Description XmTabList is the data type for a tab list. A tab list consists of tab stop list entries (XmTabs). Whenever a tab component is encountered while an XmString is being rendered, the origin of the next X draw depends on the next…
XmTabGetValues — A convenience function that returns tab values Synopsis #include <Xm/Xm.h> float XmTabGetValues( XmTab tab, unsigned char *units, XmOffsetModel *offset, unsigned char *alignment, char **decimal); Description XmTabGetValues takes an XmTab structure, returns the floating point number that is set as the value of the tab, and then sets values for the units, offset, alignment,…
XmTabFree — A convenience function that frees a tab Synopsis #include <Xm/Xm.h> void XmTabFree( XmTab tab); Description XmTabFree frees the memory associated with the specified tab. tab Specifies the tab to be freed. Related XmTab(3).
XmTabCreate — A convenience function that creates a tab stop Synopsis #include <Xm/Xm.h> XmTab XmTabCreate( float value, unsigned char units, XmOffsetModel offset_model, unsigned char alignment, char *decimal); Description XmTabCreate creates a tab stop at a position defined by the value and units arguments. value Specifies the floating point value to be used in conjunction with…
XmTab — Data type for a tab stop Synopsis #include <Xm/Xm.h> XmTab Description XmTab is a data structure that specifies a tab stop to be used in rendering an XmString containing tab components. An XmTab value contains a value, a unit type, an offset model (either XmABSOLUTE or XmRELATIVE), an alignment model (XmALIGNMENT_BEGINNING), and a…
XmStringWidth — A compound string function that returns the width of the widest line in a compound string Synopsis #include <Xm/Xm.h> Dimension XmStringWidth( XmRenderTable rendertable, XmString string); Description XmStringWidth returns the width, in pixels, of the widest line in the provided compound string. rendertable Specifies the render table string Specifies the string Return Returns the…
XmStringUnparse — A compound string function that unparses text Synopsis #include <Xm/Xm.h> XtPointer XmStringUnparse( XmString string, XmStringTag tag, XmTextType tag_type, XmTextType output_type, XmParseTable parse_table, Cardinal parse_count, XmParseModel parse_model); Description XmStringUnparse looks in the input string for text segments that are tagged with locale or charset tags that match tag. The tag_type parameter specifies whether the…
XmStringToXmStringTable — A convenience function that converts a single compound string to a table of compound strings Synopsis #include <Xm/Xm.h> Cardinal XmStringToXmStringTable( XmString string, XmString break_component, XmStringTable *table); Description XmStringToXmStringTable takes as input a single compound string and a specified string component (such as a tab) and returns a table of compound strings consisting of…
XmStringTableUnparse — A convenience function that converts a table of compound strings to an array of text Synopsis #include <Xm/Xm.h> XtPointer * XmStringTableUnparse( XmStringTable table, Cardinal count, XmStringTag tag, XmTextType tag_type, XmTextType output_type, XmParseTable parse, Cardinal parse_count, XmParseModel parse_model); Description XmStringTableUnparse takes an array of compound strings, allocates a string array for the type of…
XmStringTableToXmString — A convenience function that converts a compound string table to a single compound string Synopsis #include <Xm/Xm.h> XmString XmStringTableToXmString( XmStringTable table, Cardinal count, XmString break_component); Description XmStringTableToXmString takes as input table of compound strings and a specified string component (such as a tab) and returns a single compound string consisting of each of…
XmStringTableProposeTablist — A convenience function that returns a tab list Synopsis #include <Xm/Xm.h> XmTabList XmStringTableProposeTablist( XmStringTable strings, Cardinal num_strings, Widget widget, float pad_value, XmOffsetModel offset_model); Description XmStringTableProposeTablist takes an XmStringTable structure containing tabbed compound strings, information on padding between columns, and rendering information and returns a tab list that, if used to render the strings…
XmStringTableParseStringArray — A convenience function that converts an array of strings to a compound string table Synopsis #include <Xm/Xm.h> XmStringTable XmStringTableParseStringArray( XtPointer *strings, Cardinal count, XmStringTag tag, XmTextType type, XmParseTable parse, Cardinal parse_count, XtPointer call_data); Description XmStringTableParseStringArray takes an array of strings, allocates an XmStringTable with an equal number of slots, calls XmStringParseText on each…
XmStringTable — Data type for an array of compound strings Synopsis #include <Xm/Xm.h> Description XmStringTable is the data type for an array of compound strings (objects of type XmString). Related XmString(3).
XmStringSeparatorCreate — A compound string function that creates a compound string Synopsis #include <Xm/Xm.h> XmString XmStringSeparatorCreate(void) Description XmStringSeparatorCreate creates a compound string with a single component, a separator. Return Returns a new compound string. When the application no longer needs the returned compound string, the application should call XmStringFree. Related XmStringCreate(3).
XmStringSegmentCreate — A compound string function that creates a compound string Synopsis #include <Xm/Xm.h> XmString XmStringSegmentCreate( char * text, XmStringTag tag, XmStringDirection direction, Boolean separator); Description This function is obsolete and exists for compatibility with previous releases. It can be replaced by using a combination of XmStringComponentCreate and XmStringConcat. XmStringSegmentCreate is a high-level function that…
XmStringPutRendition — A convenience function that places renditions around strings Synopsis #include <Xm/Xm.h> XmString XmStringPutRendition( XmString string, XmStringTag rendition); Description XmStringPutRendition places matching Xm_STRING_COMPONENT_RENDITION_BEGIN and XmSTRING_COMPONENT_RENDITION_END components containing rendition around string. The original string is preserved. string Specifies the compound string to which begin and end rendition components should be added. rendition Specifies the rendition…
XmStringPeekNextTriple — A function that returns the component type of the next component Synopsis #include <Xm/Xm.h> XmStringComponentType XmStringPeekNextTriple( XmStringContext context); Description XmStringPeekNextTriple examines the next component that would be fetched by XmStringGetNextTriple and returns the component type. context Specifies the string context structure that was allocated by the XmStringInitContext function. Return Returns the type of…
XmStringPeekNextComponent — A compound string function that returns the component type of the next component to be fetched Synopsis #include <Xm/Xm.h> XmStringComponentType XmStringPeekNextComponent( XmStringContext context); Description This function is obsolete and exists for compatibility with previous releases. It is replaced by XmStringPeekNextTriple. XmStringPeekNextComponent examines the next component that would be fetched by XmStringGetNextComponent and returns…