NAME

XmText - Motif-compatible text-editing widget

SYNOPSIS

#include <Xm/Text.h>

XmText

XmCreateText

DESCRIPTION

XmText

X RESOURCES

Name	Class	Type	Default	Access
XmNsource	XmCSource	Pointer	NULL	CSG
XmNactivateCallback	XmCCallback	Callback	NULL	CSG
XmNfocusCallback	XmCCallback	Callback	NULL	CSG
XmNlosingFocusCallback	XmCCallback	Callback	NULL	CSG
XmNvalueChangedCallback	XmCCallback	Callback	NULL	CSG
XmNmodifyVerifyCallback	XmCCallback	Callback	NULL	CSG
XmNmodifyVerifyCallbackWcs	XmCCallback	Callback	NULL	CSG
XmNmotionVerifyCallback	XmCCallback	Callback	NULL	CSG
XmNgainPrimaryCallback	XmCCallback	Callback	NULL	CSG
XmNlosePrimaryCallback	XmCCallback	Callback	NULL	CSG
XmNvalue	XmCValue	String		CSG
XmNvalueWcs	XmCValueWcs	ValueWcs	(null)	CSG
XmNmaxLength	XmCMaxLength	Int	2147483647	CSG
XmNmarginHeight	XmCMarginHeight	VerticalDimension	NULL	CSG
XmNmarginWidth	XmCMarginWidth	HorizontalDimension	NULL	CSG
XmNoutputCreate	XmCOutputCreate	Function	NULL	CSG
XmNinputCreate	XmCInputCreate	Function	NULL	CSG
XmNtopCharacter	XmCTopCharacter	TextPosition	NULL	CSG
XmNcursorPosition	XmCCursorPosition	TextPosition	NULL	CSG
XmNeditMode	XmCEditMode	EditMode	NULL	CSG
XmNautoShowCursorPosition	XmCAutoShowCursorPosition	Boolean	NULL	CSG
XmNeditable	XmCEditable	Boolean	NULL	CSG
XmNverifyBell	XmCVerifyBell	Boolean	NULL	CSG
XmNshadowThickness	XmCShadowThickness	HorizontalDimension	NULL	CSG
XmNhighlightThickness	XmCHighlightThickness	HorizontalDimension	NULL	CSG
XmNnavigationType	XmCNavigationType	NavigationType	NULL	CSG

XmNsource

XmNactivateCallback

XmNfocusCallback

XmNlosingFocusCallback

XmNvalueChangedCallback

XmNmodifyVerifyCallback

XmNmodifyVerifyCallbackWcs

XmNmotionVerifyCallback

XmNgainPrimaryCallback

XmNlosePrimaryCallback

XmNvalue

XmNvalueWcs

XmNmaxLength

XmNmarginHeight

XmNmarginWidth

XmNoutputCreate

XmNinputCreate

XmNtopCharacter

XmNcursorPosition

XmNeditMode

XmNautoShowCursorPosition

XmNeditable

XmNverifyBell

XmNshadowThickness

XmNhighlightThickness

XmNnavigationType

CLASS HIERARCHY

Object(3) Rect(3) UnNamedObj(3) Core(3) XmPrimitive(3) XmText(3)

CALLBACKS

The XmText widget defines a large number of callback lists : XmNactivateCallback, XmNfocusCallback, XmNlosingFocusCallback, XmNvalueChangedCallback, XmNmodifyVerifyCallback, XmNmodifyVerifyCallbackWcs, XmNmotionVerifyCallback, XmNgainPrimaryCallback, XmNlosePrimaryCallback. The XmNactivateCallback can only be called if the XmNeditMode is XmSINGLE_LINE_EDIT. typedef struct { int reason; XEvent *event; Boolean doit; XmTextPosition currInsert, newInsert; XmTextPosition startPos, endPos; XmTextBlock text; } XmTextVerifyCallbackStruct, *XmTextVerifyPtr;

typedef struct { char *ptr; int length; XmTextFormat format; } XmTextBlockRec, *XmTextBlock;

typedef struct { wchar_t *wcsptr; int length; } XmTextBlockRecWcs, *XmTextBlockWcs;

typedef struct { int reason; XEvent *event; Boolean doit; XmTextPosition currInsert, newInsert; XmTextPosition startPos, endPos; XmTextBlockWcs text; } XmTextVerifyCallbackStructWcs, *XmTextVerifyPtrWcs;

ACTIONS

activate()

backward-character()

backward-paragraph()

backward-word()

beep()

beginning-of-file()

beginning-of-line()

clear-selection()

copy-clipboard()

copy-primary()

copy-to()

cut-clipboard()

cut-primary()

delete-next-character()

delete-previous-character()

delete-next-word()

delete-previous-word()

delete-selection()

delete-to-end-of-line()

delete-to-start-of-line()

delete-all()

do-quick-action()

end-of-file()

end-of-line()

extend-adjust()

extend-end()

extend-start()

forward-character()

forward-paragraph()

forward-word()

focus-in()

focus-out()

grab-focus()

Help()

insert-string()

key-select()

kill-next-character()

kill-next-word()

kill-previous-character()

kill-previous-word()

kill-selection()

kill-to-end-of-line()

kill-to-start-of-line()

move-destination()

move-to()

newline()

newline-and-backup()

newline-and-indent()

next-line()

next-page()

next-tab-group()

page-left()

page-right()

paste-clipboard()

prev-tab-group()

previous-line()

previous-page()

process-bdrag()

process-cancel()

process-down()

process-up()

process-home()

process-return()

process-shift_down()

process-shift-up()

process-tab()

quick-copy-set()

quick-cut-set()

redraw-display()

scroll-one-line-down()

scroll-one-line-up()

secondary-adjust()

secondary-notify()

secondary-start()

select-adjust()

select-all()

select-end()

select-start()

self-insert()

set-anchor()

set-insertion-point()

set-selection-hint()

toggle-add-mode()

traverse-home()

traverse-next()

traverse-prev()

unkill()

CONVENIENCE FUNCTIONS

XmTextClearSelection(Widget w,Time time)

Clears the primary selection from the Text Widget.

Boolean XmTextCopy(Widget w,Time time)

Copies the primary selection from the Text Widget to the Clipboard.

Boolean XmTextCut(Widget w,Time time)

Copies the primary selection from the Text Widget to the Clipboard and deletes it from the Text Widget.

int XmTextGetBaseline(Widget w)

Gets the X position of the first baseline in the Text Widget.

Boolean XmTextGetEditable(Widget w)

Determine the Editable permission state.

XmTextPosition XmTextGetInsertionPositiom(Widget w)

Determine the insertion position of the cursor.

XmTextPosition XmTextGetLastPosition(Widget w)

Determine the position of the last character in the Text Widget.

int XmTextGetMaxLength(Widget w)

Determine the maximum allowable text string length.

char *XmTextGetSelection(Widget w)

Gets the string that is in the primary selection.

Boolean XmTextGetSelectionPosition(Widget w,XmTextPosition *left,XmTextPosition *right)

Accesses the position of the Lest and Right position of the primary position.

XmTextSource XmTextGetSource(Widget w)

obtain the source of the Text Widget.

char *XmTextGetString(Widget w)

Obtain the text from the Text Widget.

XmTextPosition XmTextGetTopCharacter(Widget w)

Determine the position of the top of the text in the Text Widget.

void XmTextInsert(Widget w,XmTextPosition pos ,char *value)

Insert a string into the text string at a position determined by pos.

Boolean XmTextPaste(Widget w)

Insert the clipboard selection into the Text Widget.

Boolean XmTextPosToXY(Widget w,XmTextPosition pos, Position *x,Position *y)

Converts a TextPosition into a x,y position.

Boolean XmTextRemove(Widget w)

Deletes the primary selection.

void XmTextReplace(Widget w,XmTextPosition a,XmTextPosition b,char *value)

Replace the text from a to b with that given in value.

void XmTextScroll(Widget w,int num_of_lines)

Scroll the TextWidget num_of_lines.

void XmTextSetAddMode(Widget w,Boolean state)

Sets the Add Mode state of the Text Widget.

void XmTextSetEditable(Widget w,Boolean state)

Sets the Editable state of the Text Widget.

void XmTextSetHighlight(Widget w,XmTextPosition left,XmTextPosition right, XmHighLightMode mode)

Highlights the text between the two positions.

void XmTextSetInsertionPosition(Widget w,XmTextPosition pos)

Set the position of the insertion cursor.

void XmTextSetMaxLength(Widget w,int max_length)

Set the maximum length of the text string of the text widget.

void XmTextSetSelection(Widget w,XmTextPosition first,XmTextPosition last,Time time)

Set the primary selection of of the text widget.

void XmTextSetSource(Widget w,XmTextSource source,XmTextPosition top_char,XmTextPosition cursor_pos)

Set the text source for the text widget.

void XmTextSetString(Widget w,char *value)

Set the String value.

void XmTextSetTopCharacter(Widget w,XmTextPosition top_character)

Sets the position of the first character displayed.

void XmTextShowPosition(Widget w,XmTextPosition)

Show the text at a given position.

XmTextPosition XmTextXYToPos(Widget w,Position x,Position y)

Converts an X,Y position into an XmTextPosition.