manpagez: man pages & more
man XmTextGetTopCharacter(3)
Home | html | info | man
XmTextGetTopCharacter(library call)        XmTextGetTopCharacter(library call)




NAME

       XmTextGetTopCharacter  -- A Text function that accesses the position of
       the first character displayed


SYNOPSIS

       #include <Xm/Text.h>
       XmTextPosition XmTextGetTopCharacter(
       Widget widget);


DESCRIPTION

       XmTextGetTopCharacter accesses the position of the text at the  top  of
       the  Text  widget.   If  there  is no text in the Text widget (in other
       words, XmNvalue contains an empty string),  then  XmTextGetTopCharacter
       returns 0.

       Suppose  that  the  XmNtopCharacter  resource  has  been set to a value
       greater than the number of characters in the text widget. In this case,
       XmTextGetTopCharacter  returns  an XmTextPosition value identifying the
       position of the first character in the last line of text in a multiline
       case;  otherwise,  it  identifies the position of the last character in
       the line.

       widget    Specifies the Text widget ID

       For a complete definition of Text and  its  associated  resources,  see
       XmText(3).


RETURN

       Returns  an  XmTextPosition  value that indicates the state of the XmN-
       topCharacter resource. This is an integer number of characters from the
       beginning of the text buffer. The first character position is 0 (zero).


RELATED

       XmText(3).



                                           XmTextGetTopCharacter(library call)

openMotif 2.3.1 - Generated Thu Dec 4 08:52:21 CST 2008
© manpagez.com 2000-2025
Individual documents may contain additional copyright information.