XmRendition(3)
NAME
XmRendition --- The Rendition registry "XmRendition"
SYNOPSIS
#include <Xm/Xm.h> XmRendition
DESCRIPTION
XmRendition is a pseudo widget used for the rendering of XmStrings.
XmRendition has two parts: XmStringTag and rendering information. The
XmStringTag part can be matched with an XmStringTag associated with a
LOCALE, CHARSET, or RENDITION[BEGIN|END] component within XmString.
The rendering information contains information about the font or
fontset, colors, tabs, and lines to be used in rendering a text
component.
If a resource in a rendition is unspecified, usually by setting it to
XmAS_IS or XmUNSPECIFIED_PIXEL, then the value to be used for that
resource is the value of the immediately preceding rendition in
XmString. If that value is unspecified, then the preceding value is
used, and so on. If no renditions specify a value for a resource, then
a default value will be used.
Classes
XmRendition does not inherit from any widget class.
New Resources
The following table defines a set of widget resources used by the
programmer to specify data. 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
XmRenditionUpdate (S), retrieved by using XmRenditionRetrieve (G), or
is not applicable (N/A).
XmRendition Resource Set
Name Class Type Default Access
XmNrenditionBackground XmCRenditionBackground Pixel XmUNSPECIFIED_PIXEL CSG
XmNfont XmCFont XtPointer XmAS_IS CSG
XmNfontName XmCFontName String XmAS_IS CSG
XmNfontType XmCFontType XmFontType XmAS_IS CSG
XmNrenditionForeground XmCRenditionForeground Pixel XmUNSPECIFIED_PIXEL CSG
XmNloadModel XmCLoadModel unsigned char XmAS_IS CSG
XmNstrikethruType XmCStrikethruType unsigned char XmAS_IS CSG
XmNtabList XmCTabList XmTabList XmAS_IS CSG
XmNtag XmCTag XmStringTag "" G
XmNunderlineType XmCUnderlineType unsigned char XmAS_IS CSG
XmNrenditionBackground
Specifies the background drawing color. A value of
XmUNSPECIFIED_PIXEL indicates that the background is not
specified for this rendition.
XmNfont Specifies the actual font or fontset to be used by this
rendition. The value of this resource, if set to other than
XmAS_IS, will be used regardless of the settings of the other
font resources. Setting this resource will force XmNloadModel
to be XmLOAD_IMMEDIATE. If this resource is not initially
set, then it will be set subsequently by the rendition
whenever the font or fontset specified by XmNfontName is
loaded. If both XmNfontName and XmNfont are specified in a
resource file, the XmNfont specification will take
precedence.
XmNfontName
Specifies an X Logical Font Description (XLFD) string, which
is interpreted either as a font name or as a base font name
list. A base font name list is a comma-separated and NULL-
terminated string. A value of XmAS_IS indicates that the font
is not specified for this rendition. If both XmNfontName and
XmNfont are specified in a resource file, the XmNfont
specification will take precedence.
XmNfontType
Specifies whether the XmNfontName resource refers to a font
name or to a base font name list. Valid values are
XmFONT_IS_FONT and XmFONT_IS_FONTSET.
XmNrenditionForeground
Specifies the foreground drawing color. A value of
XmUNSPECIFIED_PIXEL indicates that the foreground is not
specified for this rendition.
XmNloadModel
Specifies whether the font or fontset specified by
XmNfontName is to be loaded when the rendition is created
(XmLOAD_IMMEDIATE) or only when the font is required to
render an XmString segment (XmLOAD_DEFERRED). Note that
specifying XmLOAD_IMMEDIATE for XmNloadModel is valid only if
XmNfontName is specified, in which case the specified font
will be loaded on creation, or if XmNfont is specified, in
which case the font is already loaded. XmLOAD_DEFERRED is
only valid when XmNfontName is specified.
XmNstrikethruType
Specifies the type of line to be used to strike through a
text segment. Valid values are XmNO_LINE, XmSINGLE_LINE,
XmDOUBLE_LINE, XmSINGLE_DASHED_LINE, and
XmDOUBLE_DASHED_LINE. A value of XmAS_IS indicates that the
strike-through type is not specified for this rendition.
XmNtabList
Specifies the tab list to be used in rendering compound
strings containing tab components.
XmNtag Specifies the tag string to be used in matching the
renditions with other renditions or with XmStringTag
components in XmStrings. This resource must always be
specified. That is, NULL is not a legal value but the empty
string is. This resource is automatically set to the value
of the tag parameter in the XmRenditionCreate call.
XmNunderlineType
Specifies the type of line to be used to underline a text
segment. Valid values are XmNO_LINE, XmSINGLE_LINE,
XmDOUBLE_LINE, XmSINGLE_DASHED_LINE, and
XmDOUBLE_DASHED_LINE. A value of XmAS_IS indicates that the
underline type is not specified for this rendition.
RELATED
XmRenditionCreate(3), XmRenditionFree(3), XmRenditionRetrieve(3), XmRenditionUpdate(3), and XmString(3). XmRendition(3)
Opportunity
Personal Opportunity - Free software gives you access to billions of dollars of software at no cost. Use this software for your business, personal use or to develop a profitable skill. Access to source code provides access to a level of capabilities/information that companies protect though copyrights. Open source is a core component of the Internet and it is available to you. Leverage the billions of dollars in resources and capabilities to build a career, establish a business or change the world. The potential is endless for those who understand the opportunity.
Business Opportunity - Goldman Sachs, IBM and countless large corporations are leveraging open source to reduce costs, develop products and increase their bottom lines. Learn what these companies know about open source and how open source can give you the advantage.
Free Software
Free Software provides computer programs and capabilities at no cost but more importantly, it provides the freedom to run, edit, contribute to, and share the software. The importance of free software is a matter of access, not price. Software at no cost is a benefit but ownership rights to the software and source code is far more significant.
Free Office Software - The Libre Office suite provides top desktop productivity tools for free. This includes, a word processor, spreadsheet, presentation engine, drawing and flowcharting, database and math applications. Libre Office is available for Linux or Windows.
Free Books
The Free Books Library is a collection of thousands of the most popular public domain books in an online readable format. The collection includes great classical literature and more recent works where the U.S. copyright has expired. These books are yours to read and use without restrictions.
Source Code - Want to change a program or know how it works? Open Source provides the source code for its programs so that anyone can use, modify or learn how to write those programs themselves. Visit the GNU source code repositories to download the source.
Education
Study at Harvard, Stanford or MIT - Open edX provides free online courses from Harvard, MIT, Columbia, UC Berkeley and other top Universities. Hundreds of courses for almost all major subjects and course levels. Open edx also offers some paid courses and selected certifications.
Linux Manual Pages - A man or manual page is a form of software documentation found on Linux/Unix operating systems. Topics covered include computer programs (including library and system calls), formal standards and conventions, and even abstract concepts.
