<HTML>
<HEAD><TITLE>Manpage of XmText</TITLE>
</HEAD><BODY>
<H1>XmText</H1>
Section: LessTif Manuals (3)<BR>Updated: April 1998<BR><A HREF="#index">Index</A>
<BR><A HREF="http://localhost/cgi-bin/man2html">Return to Main Contents</A>
<HR>
<A NAME="lbAB"> </A>
<H2>NAME</H2>
XmText - Motif-compatible text-editing widget
<A NAME="lbAC"> </A>
<H2>SYNOPSIS</H2>
<B>#include <<A HREF="file:/usr/include/Xm/Text.h">Xm/Text.h</A>></B>
<P>
<B>XmText</B>
<P>
<B>XmCreateText</B>
<A NAME="lbAD"> </A>
<H2>DESCRIPTION</H2>
XmText
<A NAME="lbAE"> </A>
<H2>X RESOURCES</H2>
<TABLE>
<TR VALIGN=top><TD>Name</TD><TD>Class</TD><TD>Type</TD><TD>Default</TD><TD>Access<BR></TD></TR>
<TR VALIGN=top><TD COLSPAN=5><HR></TD></TR>
<TR VALIGN=top><TD>XmNsource</TD><TD>XmCSource</TD><TD>Pointer</TD><TD>NULL</TD><TD>CSG<BR></TD></TR>
<TR VALIGN=top><TD>XmNactivateCallback</TD><TD>XmCCallback</TD><TD>Callback</TD><TD>NULL</TD><TD>CSG<BR></TD></TR>
<TR VALIGN=top><TD>XmNfocusCallback</TD><TD>XmCCallback</TD><TD>Callback</TD><TD>NULL</TD><TD>CSG<BR></TD></TR>
<TR VALIGN=top><TD>XmNlosingFocusCallback</TD><TD>XmCCallback</TD><TD>Callback</TD><TD>NULL</TD><TD>CSG<BR></TD></TR>
<TR VALIGN=top><TD>XmNvalueChangedCallback</TD><TD>XmCCallback</TD><TD>Callback</TD><TD>NULL</TD><TD>CSG<BR></TD></TR>
<TR VALIGN=top><TD>XmNmodifyVerifyCallback</TD><TD>XmCCallback</TD><TD>Callback</TD><TD>NULL</TD><TD>CSG<BR></TD></TR>
<TR VALIGN=top><TD>XmNmodifyVerifyCallbackWcs</TD><TD>XmCCallback</TD><TD>Callback</TD><TD>NULL</TD><TD>CSG<BR></TD></TR>
<TR VALIGN=top><TD>XmNmotionVerifyCallback</TD><TD>XmCCallback</TD><TD>Callback</TD><TD>NULL</TD><TD>CSG<BR></TD></TR>
<TR VALIGN=top><TD>XmNgainPrimaryCallback</TD><TD>XmCCallback</TD><TD>Callback</TD><TD>NULL</TD><TD>CSG<BR></TD></TR>
<TR VALIGN=top><TD>XmNlosePrimaryCallback</TD><TD>XmCCallback</TD><TD>Callback</TD><TD>NULL</TD><TD>CSG<BR></TD></TR>
<TR VALIGN=top><TD>XmNvalue</TD><TD>XmCValue</TD><TD>String</TD><TD></TD><TD>CSG<BR></TD></TR>
<TR VALIGN=top><TD>XmNvalueWcs</TD><TD>XmCValueWcs</TD><TD>ValueWcs</TD><TD>(null)</TD><TD>CSG<BR></TD></TR>
<TR VALIGN=top><TD>XmNmaxLength</TD><TD>XmCMaxLength</TD><TD>Int</TD><TD>2147483647</TD><TD>CSG<BR></TD></TR>
<TR VALIGN=top><TD>XmNmarginHeight</TD><TD>XmCMarginHeight</TD><TD>VerticalDimension</TD><TD>NULL</TD><TD>CSG<BR></TD></TR>
<TR VALIGN=top><TD>XmNmarginWidth</TD><TD>XmCMarginWidth</TD><TD>HorizontalDimension</TD><TD>NULL</TD><TD>CSG<BR></TD></TR>
<TR VALIGN=top><TD>XmNoutputCreate</TD><TD>XmCOutputCreate</TD><TD>Function</TD><TD>NULL</TD><TD>CSG<BR></TD></TR>
<TR VALIGN=top><TD>XmNinputCreate</TD><TD>XmCInputCreate</TD><TD>Function</TD><TD>NULL</TD><TD>CSG<BR></TD></TR>
<TR VALIGN=top><TD>XmNtopCharacter</TD><TD>XmCTopCharacter</TD><TD>TextPosition</TD><TD>NULL</TD><TD>CSG<BR></TD></TR>
<TR VALIGN=top><TD>XmNcursorPosition</TD><TD>XmCCursorPosition</TD><TD>TextPosition</TD><TD>NULL</TD><TD>CSG<BR></TD></TR>
<TR VALIGN=top><TD>XmNeditMode</TD><TD>XmCEditMode</TD><TD>EditMode</TD><TD>NULL</TD><TD>CSG<BR></TD></TR>
<TR VALIGN=top><TD>XmNautoShowCursorPosition</TD><TD>XmCAutoShowCursorPosition</TD><TD>Boolean</TD><TD>NULL</TD><TD>CSG<BR></TD></TR>
<TR VALIGN=top><TD>XmNeditable</TD><TD>XmCEditable</TD><TD>Boolean</TD><TD>NULL</TD><TD>CSG<BR></TD></TR>
<TR VALIGN=top><TD>XmNverifyBell</TD><TD>XmCVerifyBell</TD><TD>Boolean</TD><TD>NULL</TD><TD>CSG<BR></TD></TR>
<TR VALIGN=top><TD>XmNshadowThickness</TD><TD>XmCShadowThickness</TD><TD>HorizontalDimension</TD><TD>NULL</TD><TD>CSG<BR></TD></TR>
<TR VALIGN=top><TD>XmNhighlightThickness</TD><TD>XmCHighlightThickness</TD><TD>HorizontalDimension</TD><TD>NULL</TD><TD>CSG<BR></TD></TR>
<TR VALIGN=top><TD>XmNnavigationType</TD><TD>XmCNavigationType</TD><TD>NavigationType</TD><TD>NULL</TD><TD>CSG<BR></TD></TR>
</TABLE>
<P>
<B>XmNsource</B>
<P>
<B>XmNactivateCallback</B>
<P>
<B>XmNfocusCallback</B>
<P>
<B>XmNlosingFocusCallback</B>
<P>
<B>XmNvalueChangedCallback</B>
<P>
<B>XmNmodifyVerifyCallback</B>
<P>
<B>XmNmodifyVerifyCallbackWcs</B>
<P>
<B>XmNmotionVerifyCallback</B>
<P>
<B>XmNgainPrimaryCallback</B>
<P>
<B>XmNlosePrimaryCallback</B>
<P>
<B>XmNvalue</B>
<P>
<B>XmNvalueWcs</B>
<P>
<B>XmNmaxLength</B>
<P>
<B>XmNmarginHeight</B>
<P>
<B>XmNmarginWidth</B>
<P>
<B>XmNoutputCreate</B>
<P>
<B>XmNinputCreate</B>
<P>
<B>XmNtopCharacter</B>
<P>
<B>XmNcursorPosition</B>
<P>
<B>XmNeditMode</B>
<P>
<B>XmNautoShowCursorPosition</B>
<P>
<B>XmNeditable</B>
<P>
<B>XmNverifyBell</B>
<P>
<B>XmNshadowThickness</B>
<P>
<B>XmNhighlightThickness</B>
<P>
<B>XmNnavigationType</B>
<P>
<A NAME="lbAF"> </A>
<H2>CLASS HIERARCHY</H2>
<B><A HREF="Object.html">Object</A></B>(3)
<B><A HREF="Rect.html">Rect</A></B>(3)
<B><A HREF="UnNamedObj.html">UnNamedObj</A></B>(3)
<B><A HREF="Core.html">Core</A></B>(3)
<B><A HREF="XmPrimitive.html">XmPrimitive</A></B>(3)
<B><A HREF="XmText.html">XmText</A></B>(3)
<A NAME="lbAG"> </A>
<H2>CALLBACKS</H2>
The XmText widget defines a large number of callback lists :
<B>XmNactivateCallback</B>,
<B>XmNfocusCallback</B>,
<B>XmNlosingFocusCallback</B>,
<B>XmNvalueChangedCallback</B>,
<B>XmNmodifyVerifyCallback</B>,
<B>XmNmodifyVerifyCallbackWcs</B>,
<B>XmNmotionVerifyCallback</B>,
<B>XmNgainPrimaryCallback</B>,
<B>XmNlosePrimaryCallback</B>.
The XmNactivateCallback can only be called
if the XmNeditMode is XmSINGLE_LINE_EDIT.
<FONT SIZE=-1><BR> typedef struct {</FONT>
<BR> int reason;
<BR> XEvent *event;
<BR> Boolean doit;
<BR> XmTextPosition currInsert, newInsert;
<BR> XmTextPosition startPos, endPos;
<BR> XmTextBlock text;
<BR> } XmTextVerifyCallbackStruct, *XmTextVerifyPtr;
<BR>
<BR> typedef struct {
<BR> char *ptr;
<BR> int length;
<BR> XmTextFormat format;
<BR> } XmTextBlockRec, *XmTextBlock;
<BR>
<BR> typedef struct {
<BR> wchar_t *wcsptr;
<BR> int length;
<BR> } XmTextBlockRecWcs, *XmTextBlockWcs;
<BR>
<BR> typedef struct {
<BR> int reason;
<BR> XEvent *event;
<BR> Boolean doit;
<BR> XmTextPosition currInsert, newInsert;
<BR> XmTextPosition startPos, endPos;
<BR> XmTextBlockWcs text;
<BR> } XmTextVerifyCallbackStructWcs, *XmTextVerifyPtrWcs;
<FONT SIZE=-1></FONT><A NAME="lbAH"> </A>
<H2>ACTIONS</H2>
<TABLE>
<TR VALIGN=top><TD>activate()<BR></TD></TR>
<TR VALIGN=top><TD>backward-character()<BR></TD></TR>
<TR VALIGN=top><TD>backward-paragraph()<BR></TD></TR>
<TR VALIGN=top><TD>backward-word()<BR></TD></TR>
<TR VALIGN=top><TD>beep()<BR></TD></TR>
<TR VALIGN=top><TD>beginning-of-file()<BR></TD></TR>
<TR VALIGN=top><TD>beginning-of-line()<BR></TD></TR>
<TR VALIGN=top><TD>clear-selection()<BR></TD></TR>
<TR VALIGN=top><TD>copy-clipboard()<BR></TD></TR>
<TR VALIGN=top><TD>copy-primary()<BR></TD></TR>
<TR VALIGN=top><TD>copy-to()<BR></TD></TR>
<TR VALIGN=top><TD>cut-clipboard()<BR></TD></TR>
<TR VALIGN=top><TD>cut-primary()<BR></TD></TR>
<TR VALIGN=top><TD>delete-next-character()<BR></TD></TR>
<TR VALIGN=top><TD>delete-previous-character()<BR></TD></TR>
<TR VALIGN=top><TD>delete-next-word()<BR></TD></TR>
<TR VALIGN=top><TD>delete-previous-word()<BR></TD></TR>
<TR VALIGN=top><TD>delete-selection()<BR></TD></TR>
<TR VALIGN=top><TD>delete-to-end-of-line()<BR></TD></TR>
<TR VALIGN=top><TD>delete-to-start-of-line()<BR></TD></TR>
<TR VALIGN=top><TD>delete-all()<BR></TD></TR>
<TR VALIGN=top><TD>do-quick-action()<BR></TD></TR>
<TR VALIGN=top><TD>end-of-file()<BR></TD></TR>
<TR VALIGN=top><TD>end-of-line()<BR></TD></TR>
<TR VALIGN=top><TD>extend-adjust()<BR></TD></TR>
<TR VALIGN=top><TD>extend-end()<BR></TD></TR>
<TR VALIGN=top><TD>extend-start()<BR></TD></TR>
<TR VALIGN=top><TD>forward-character()<BR></TD></TR>
<TR VALIGN=top><TD>forward-paragraph()<BR></TD></TR>
<TR VALIGN=top><TD>forward-word()<BR></TD></TR>
<TR VALIGN=top><TD>focus-in()<BR></TD></TR>
<TR VALIGN=top><TD>focus-out()<BR></TD></TR>
<TR VALIGN=top><TD>grab-focus()<BR></TD></TR>
<TR VALIGN=top><TD>Help()<BR></TD></TR>
<TR VALIGN=top><TD>insert-string()<BR></TD></TR>
<TR VALIGN=top><TD>key-select()<BR></TD></TR>
<TR VALIGN=top><TD>kill-next-character()<BR></TD></TR>
<TR VALIGN=top><TD>kill-next-word()<BR></TD></TR>
<TR VALIGN=top><TD>kill-previous-character()<BR></TD></TR>
<TR VALIGN=top><TD>kill-previous-word()<BR></TD></TR>
<TR VALIGN=top><TD>kill-selection()<BR></TD></TR>
<TR VALIGN=top><TD>kill-to-end-of-line()<BR></TD></TR>
<TR VALIGN=top><TD>kill-to-start-of-line()<BR></TD></TR>
<TR VALIGN=top><TD>move-destination()<BR></TD></TR>
<TR VALIGN=top><TD>move-to()<BR></TD></TR>
<TR VALIGN=top><TD>newline()<BR></TD></TR>
<TR VALIGN=top><TD>newline-and-backup()<BR></TD></TR>
<TR VALIGN=top><TD>newline-and-indent()<BR></TD></TR>
<TR VALIGN=top><TD>next-line()<BR></TD></TR>
<TR VALIGN=top><TD>next-page()<BR></TD></TR>
<TR VALIGN=top><TD>next-tab-group()<BR></TD></TR>
<TR VALIGN=top><TD>page-left()<BR></TD></TR>
<TR VALIGN=top><TD>page-right()<BR></TD></TR>
<TR VALIGN=top><TD>paste-clipboard()<BR></TD></TR>
<TR VALIGN=top><TD>prev-tab-group()<BR></TD></TR>
<TR VALIGN=top><TD>previous-line()<BR></TD></TR>
<TR VALIGN=top><TD>previous-page()<BR></TD></TR>
<TR VALIGN=top><TD>process-bdrag()<BR></TD></TR>
<TR VALIGN=top><TD>process-cancel()<BR></TD></TR>
<TR VALIGN=top><TD>process-down()<BR></TD></TR>
<TR VALIGN=top><TD>process-up()<BR></TD></TR>
<TR VALIGN=top><TD>process-home()<BR></TD></TR>
<TR VALIGN=top><TD>process-return()<BR></TD></TR>
<TR VALIGN=top><TD>process-shift_down()<BR></TD></TR>
<TR VALIGN=top><TD>process-shift-up()<BR></TD></TR>
<TR VALIGN=top><TD>process-tab()<BR></TD></TR>
<TR VALIGN=top><TD>quick-copy-set()<BR></TD></TR>
<TR VALIGN=top><TD>quick-cut-set()<BR></TD></TR>
<TR VALIGN=top><TD>redraw-display()<BR></TD></TR>
<TR VALIGN=top><TD>scroll-one-line-down()<BR></TD></TR>
<TR VALIGN=top><TD>scroll-one-line-up()<BR></TD></TR>
<TR VALIGN=top><TD>secondary-adjust()<BR></TD></TR>
<TR VALIGN=top><TD>secondary-notify()<BR></TD></TR>
<TR VALIGN=top><TD>secondary-start()<BR></TD></TR>
<TR VALIGN=top><TD>select-adjust()<BR></TD></TR>
<TR VALIGN=top><TD>select-all()<BR></TD></TR>
<TR VALIGN=top><TD>select-end()<BR></TD></TR>
<TR VALIGN=top><TD>select-start()<BR></TD></TR>
<TR VALIGN=top><TD>self-insert()<BR></TD></TR>
<TR VALIGN=top><TD>set-anchor()<BR></TD></TR>
<TR VALIGN=top><TD>set-insertion-point()<BR></TD></TR>
<TR VALIGN=top><TD>set-selection-hint()<BR></TD></TR>
<TR VALIGN=top><TD>toggle-add-mode()<BR></TD></TR>
<TR VALIGN=top><TD>traverse-home()<BR></TD></TR>
<TR VALIGN=top><TD>traverse-next()<BR></TD></TR>
<TR VALIGN=top><TD>traverse-prev()<BR></TD></TR>
<TR VALIGN=top><TD>unkill()<BR></TD></TR>
</TABLE>
<A NAME="lbAI"> </A>
<H2>CONVENIENCE FUNCTIONS</H2>
<B>XmTextClearSelection(Widget w,Time time)</B>
<P>
Clears the primary selection from the Text Widget.
<P>
<B>Boolean XmTextCopy(Widget w,Time time)</B>
<P>
Copies the primary selection from the Text Widget to the Clipboard.
<P>
<B>Boolean XmTextCut(Widget w,Time time)</B>
<P>
Copies the primary selection from the Text Widget to the Clipboard and deletes it from the Text Widget.
<P>
<B>int XmTextGetBaseline(Widget w)</B>
<P>
Gets the X position of the first baseline in the Text Widget.
<P>
<B>Boolean XmTextGetEditable(Widget w)</B>
<P>
Determine the Editable permission state.
<P>
<B>XmTextPosition XmTextGetInsertionPositiom(Widget w)</B>
<P>
Determine the insertion position of the cursor.
<P>
<B>XmTextPosition XmTextGetLastPosition(Widget w)</B>
<P>
Determine the position of the last character in the Text Widget.
<P>
<B>int XmTextGetMaxLength(Widget w)</B>
<P>
Determine the maximum allowable text string length.
<P>
<B>char *XmTextGetSelection(Widget w)</B>
<P>
Gets the string that is in the primary selection.
<P>
<B>Boolean XmTextGetSelectionPosition(Widget w,XmTextPosition *left,XmTextPosition *right)</B>
<P>
Accesses the position of the Lest and Right position of the primary position.
<P>
<B>XmTextSource XmTextGetSource(Widget w)</B>
<P>
obtain the source of the Text Widget.
<P>
<B>char *XmTextGetString(Widget w)</B>
<P>
Obtain the text from the Text Widget.
<P>
<B>XmTextPosition XmTextGetTopCharacter(Widget w)</B>
<P>
Determine the position of the top of the text in the Text Widget.
<P>
<B>void XmTextInsert(Widget w,XmTextPosition pos ,char *value)</B>
<P>
Insert a string into the text string at a position determined by pos.
<P>
<B>Boolean XmTextPaste(Widget w)</B>
<P>
Insert the clipboard selection into the Text Widget.
<P>
<B>Boolean XmTextPosToXY(Widget w,XmTextPosition pos, Position *x,Position *y)</B>
<P>
Converts a TextPosition into a x,y position.
<P>
<B>Boolean XmTextRemove(Widget w)</B>
<P>
Deletes the primary selection.
<P>
<B>void XmTextReplace(Widget w,XmTextPosition a,XmTextPosition b,char *value)</B>
<P>
Replace the text from a to b with that given in value.
<P>
<B>void XmTextScroll(Widget w,int num_of_lines)</B>
<P>
Scroll the TextWidget num_of_lines.
<P>
<B>void XmTextSetAddMode(Widget w,Boolean state)</B>
<P>
Sets the Add Mode state of the Text Widget.
<P>
<B>void XmTextSetEditable(Widget w,Boolean state)</B>
<P>
Sets the Editable state of the Text Widget.
<P>
<B>void XmTextSetHighlight(Widget w,XmTextPosition left,XmTextPosition right, XmHighLightMode mode)</B>
<P>
Highlights the text between the two positions.
<P>
<B>void XmTextSetInsertionPosition(Widget w,XmTextPosition pos)</B>
<P>
Set the position of the insertion cursor.
<P>
<B>void XmTextSetMaxLength(Widget w,int max_length)</B>
<P>
Set the maximum length of the text string of the text widget.
<P>
<B>void XmTextSetSelection(Widget w,XmTextPosition first,XmTextPosition last,Time time)</B>
<P>
Set the primary selection of of the text widget.
<P>
<B>void XmTextSetSource(Widget w,XmTextSource source,XmTextPosition top_char,XmTextPosition cursor_pos)</B>
<P>
Set the text source for the text widget.
<P>
<B>void XmTextSetString(Widget w,char *value)</B>
<P>
Set the String value.
<P>
<B>void XmTextSetTopCharacter(Widget w,XmTextPosition top_character)</B>
<P>
Sets the position of the first character displayed.
<P>
<B>void XmTextShowPosition(Widget w,XmTextPosition)</B>
<P>
Show the text at a given position.
<P>
<B>XmTextPosition XmTextXYToPos(Widget w,Position x,Position y)</B>
<P>
Converts an X,Y position into an XmTextPosition.
<A NAME="lbAJ"> </A>
<H2>SEE ALSO</H2>
<P>
<HR>
<A NAME="index"> </A><H2>Index</H2>
<DL>
<DT><A HREF="#lbAB">NAME</A><DD>
<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
<DT><A HREF="#lbAD">DESCRIPTION</A><DD>
<DT><A HREF="#lbAE">X RESOURCES</A><DD>
<DT><A HREF="#lbAF">CLASS HIERARCHY</A><DD>
<DT><A HREF="#lbAG">CALLBACKS</A><DD>
<DT><A HREF="#lbAH">ACTIONS</A><DD>
<DT><A HREF="#lbAI">CONVENIENCE FUNCTIONS</A><DD>
<DT><A HREF="#lbAJ">SEE ALSO</A><DD>
</DL>
<HR>
This document was created by <EM>man2html</EM>,
using the manual pages.<BR>
</BODY>
</HTML>
