Museum

Home

Lab Overview

Retrotechnology Articles

⇒ Online Manual

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

XmStringCreate(3X)

XmStringCreateSimple(3X)

XmStringDrawUnderline(3X)  —  Subroutines

OSF

NAME

XmStringDrawUnderline — a compound string function that underlines a string drawn in an X Window.

SYNOPSIS

#include <Xm/Xm.h> void XmStringDrawUnderline (d, w, fontlist, string, gc, x, y, width, alignment, layout_direction, clip,
underline)
Display∗ d;
Windoww;
XmFontListfontlist;
XmStringstring;
GCgc;
Positionx;
Positiony;
Dimensionwidth;
unsigned char alignment;
unsigned char layout_direction;
XRectangle∗ clip;
XmStringunderline;

DESCRIPTION

XmStringDrawUnderline draws a compound string in an X Window.  If the substring identified by underline can be matched in string, the substring will be underlined.  Once a match has occurred, no further matches or underlining will be done. 

When string has been created with XmStringCreateSimple, the font associated with the character set derived from the current language environment must appear at the front of fontlist.  Otherwise, the result of the function is undefined. 

dSpecifies the display. 

wSpecifies the window. 

fontlistSpecifies the font list. 

stringSpecifies the string. 

gcSpecifies the graphics context to use. 

xSpecifies a coordinate of the rectangle that will contain the displayed compound string. 

ySpecifies a coordinate of the rectangle that will contain the displayed compound string. 

widthSpecifies the width of the rectangle that will contain the displayed compound string. 

alignmentSpecifies how the string will be aligned within the specified rectangle.  It is one of XmALIGNMENT_BEGINNING, XmALIGNMENT_CENTER, or XmALIGNMENT_END. 

layout_directionControls the direction in which the segments of the compound string will be laid out.  It also determines the meaning of the alignment parameter. 

clipAllows the application to restrict the area into which the compound string will be drawn.  If NULL, no clipping will be done. 

underlineSpecifies the substring to be underlined. 

RELATED INFORMATION

XmStringCreate(3X) and XmStringCreateSimple(3X). 

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026