1<sect1 id="Text_Widget_Actions"> 2<title>Text Widget Actions</title> 3<para> 4<!-- .LP --> 5<indexterm><primary>Text widget</primary><secondary>actions</secondary></indexterm> 6<!-- .XS --> 7<!-- Actions Supported by all Text Widgets --> 8<!-- .XE --> 9<indexterm significance="preferred"><primary>Text widget</primary><secondary>actions</secondary></indexterm> 10 11All editing functions are performed by translation manager actions that may 12be specified through the <function>translations</function> resource in the Text widget. 13</para> 14<para> 15<!-- .LP --> 16<!-- .sp --> 17<literallayout class="monospaced"> 18<!-- .TA .5i 2.5i 3i --> 19<!-- .ta .5i 2.5i 3i --> 20Insert Point Movement Delete 21 forward-character delete-next-character 22 backward-character delete-previous-character 23 forward-word delete-next-word 24 backward-word delete-previous-word 25 forward-paragraph delete-selection 26 backward-paragraph 27 beginning-of-line 28 end-of-line Selection 29 next-line select-word 30 previous-line select-all 31 next-page select-start 32 previous-page select-adjust 33 beginning-of-file select-end 34 end-of-file extend-start 35 scroll-one-line-up extend-adjust 36 scroll-one-line-down extend-end 37 insert-selection 38 39 40Miscellaneous New Line 41 redraw-display newline-and-indent 42 insert-file newline-and-backup 43 insert-char newline 44 insert-string 45 display-caret 46 focus-in Kill 47 focus-in kill-word 48 search backward-kill-word 49 multiply kill-selection 50 form-paragraph kill-to-end-of-line 51 transpose-characters kill-paragraph 52 no-op kill-to-end-of-paragraph 53 XawWMProtocols 54 reconnect-im 55</literallayout> 56<!-- .sp --> 57</para> 58<para> 59<!-- .LP --> 60Most of the actions take no arguments, and unless otherwise noted you 61may assume this to be the case. 62</para> 63<para> 64<!-- .LP --> 65</para> 66<sect2 id='Cursor_Movement_Actions'> 67<title>Cursor Movement Actions</title> 68<para> 69<!-- .LP --> 70<!-- .sp --> 71<variablelist> 72 <varlistentry> 73 <term> 74 forward-character() 75 </term> 76 <listitem> 77 <para> 78<!-- .br --> 79<!-- .ns --> 80 </para> 81 </listitem> 82 </varlistentry> 83 <varlistentry> 84 <term> 85 backward-character() 86 </term> 87 <listitem> 88 <para> 89These actions move the insert point forward or backward one character in 90the buffer. If the insert point is at the end or beginning of a line 91this action will move the insert point to the next (or previous) line. 92 </para> 93 </listitem> 94 </varlistentry> 95 <varlistentry> 96 <term> 97 forward-word() 98 </term> 99 <listitem> 100 <para> 101<!-- .br --> 102<!-- .ns --> 103 </para> 104 </listitem> 105 </varlistentry> 106 <varlistentry> 107 <term> 108 backward-word() 109 </term> 110 <listitem> 111 <para> 112These actions move the insert point to the next or previous word boundary. 113A word boundary is defined as a Space, Tab or Carriage Return. 114 </para> 115 </listitem> 116 </varlistentry> 117 <varlistentry> 118 <term> 119 forward-paragraph() 120 </term> 121 <listitem> 122 <para> 123<!-- .br --> 124<!-- .ns --> 125 </para> 126 </listitem> 127 </varlistentry> 128 <varlistentry> 129 <term> 130 backward-paragraph() 131 </term> 132 <listitem> 133 <para> 134These actions move the insert point to the next or previous paragraph boundary. 135A paragraph boundary is defined as two Carriage Returns in a row with only 136Spaces or Tabs between them. 137 </para> 138 </listitem> 139 </varlistentry> 140 <varlistentry> 141 <term> 142 beginning-of-line() 143 </term> 144 <listitem> 145 <para> 146<!-- .br --> 147<!-- .ns --> 148 </para> 149 </listitem> 150 </varlistentry> 151 <varlistentry> 152 <term> 153 end-of-line() 154 </term> 155 <listitem> 156 <para> 157These actions move to the beginning or end of the current line. If the 158insert point is already at the end or beginning of the line then no action is taken. 159 </para> 160 </listitem> 161 </varlistentry> 162 <varlistentry> 163 <term> 164 next-line() 165 </term> 166 <listitem> 167 <para> 168<!-- .br --> 169<!-- .ns --> 170 </para> 171 </listitem> 172 </varlistentry> 173 <varlistentry> 174 <term> 175 previous-line() 176 </term> 177 <listitem> 178 <para> 179These actions move the insert point up or down one line. If the insert 180point is currently N characters from the beginning of the line then it 181will be N characters from the beginning of the next or previous line. 182If N is past the end of the line, the insert point is placed at the end 183of the line. 184 </para> 185 </listitem> 186 </varlistentry> 187 <varlistentry> 188 <term> 189 next-page() 190 </term> 191 <listitem> 192 <para> 193<!-- .br --> 194<!-- .ns --> 195 </para> 196 </listitem> 197 </varlistentry> 198 <varlistentry> 199 <term> 200 previous-page() 201 </term> 202 <listitem> 203 <para> 204These actions move the insert point up or down one page in the file. 205One page is defined as the current height of the text widget. The 206insert point is always placed at the first character of the top line by 207this action. 208 </para> 209 </listitem> 210 </varlistentry> 211 <varlistentry> 212 <term> 213 beginning-of-file() 214 </term> 215 <listitem> 216 <para> 217<!-- .br --> 218<!-- .ns --> 219 </para> 220 </listitem> 221 </varlistentry> 222 <varlistentry> 223 <term> 224 end-of-file() 225 </term> 226 <listitem> 227 <para> 228These actions place the insert point at the beginning or end of the 229current text buffer. The text widget is then scrolled the minimum 230amount necessary to make the new insert point location visible. 231 </para> 232 </listitem> 233 </varlistentry> 234 <varlistentry> 235 <term> 236 scroll-one-line-up() 237 </term> 238 <listitem> 239 <para> 240<!-- .br --> 241<!-- .ns --> 242 </para> 243 </listitem> 244 </varlistentry> 245 <varlistentry> 246 <term> 247 scroll-one-line-down() 248 </term> 249 <listitem> 250 <para> 251These actions scroll the current text field up or down by one line. 252They do not move the insert point. Other than the scrollbars this is 253the only way that the insert point may be moved off of the visible text 254area. The widget will be scrolled so that the insert point is back on 255the screen as soon as some other action is executed. 256 </para> 257 </listitem> 258 </varlistentry> 259</variablelist> 260</para> 261</sect2> 262<sect2 id="Delete_Actions"> 263<title>Delete Actions</title> 264<para> 265<!-- .LP --> 266<!-- .sp --> 267<variablelist> 268 <varlistentry> 269 <term> 270 delete-next-character() 271 </term> 272 <listitem> 273 <para> 274<!-- .br --> 275<!-- .ns --> 276 </para> 277 </listitem> 278 </varlistentry> 279 <varlistentry> 280 <term> 281 delete-previous-character() 282 </term> 283 <listitem> 284 <para> 285These actions remove the character immediately before or after the 286insert point. If a Carriage Return is removed then the next line is 287appended to the end of the current line. 288 </para> 289 </listitem> 290 </varlistentry> 291 <varlistentry> 292 <term> 293 delete-next-word() 294 </term> 295 <listitem> 296 <para> 297<!-- .br --> 298<!-- .ns --> 299 </para> 300 </listitem> 301 </varlistentry> 302 <varlistentry> 303 <term> 304 delete-previous-word() 305 </term> 306 <listitem> 307 <para> 308These actions remove all characters between the insert point location and 309the next word boundary. A word boundary is defined as a Space, Tab or 310Carriage Return. 311 </para> 312 </listitem> 313 </varlistentry> 314 <varlistentry> 315 <term> 316 delete-selection() 317 </term> 318 <listitem> 319 <para> 320This action removes all characters in the current selection. 321The selection can be set with the selection actions. 322 </para> 323 </listitem> 324 </varlistentry> 325</variablelist> 326</para> 327</sect2> 328<sect2 id="Selection_Actions"> 329<title>Selection Actions</title> 330<para> 331<!-- .LP --> 332<!-- .sp --> 333<variablelist> 334 <varlistentry> 335 <term> 336 select-word() 337 </term> 338 <listitem> 339 <para> 340This action selects the word in which the insert point is currently located. 341If the insert point is between words then it will select the previous word. 342 </para> 343 </listitem> 344 </varlistentry> 345 <varlistentry> 346 <term> 347 select-all() 348 </term> 349 <listitem> 350 <para> 351This action selects the entire text buffer. 352 </para> 353 </listitem> 354 </varlistentry> 355 <varlistentry> 356 <term> 357 select-start() 358 </term> 359 <listitem> 360 <para> 361This action sets the insert point to the current pointer location (if 362triggered by a button event) or text cursor location (if triggered by 363a key event). It 364will then begin a selection at this location. If many of these 365selection actions occur quickly in succession then the selection count 366mechanism will be invoked (see 367<xref linkend="Text_Selections_for_Application_Programmers"/> 368for details). 369 </para> 370 </listitem> 371 </varlistentry> 372 <varlistentry> 373 <term> 374 select-adjust() 375 </term> 376 <listitem> 377 <para> 378This action allows a selection started with the <emphasis remap='I'>select-start</emphasis> 379action to be modified, as described above. 380 </para> 381 </listitem> 382 </varlistentry> 383 <varlistentry> 384 <term> 385 select-end(<emphasis remap='I'>name</emphasis>[,<emphasis remap='I'>name</emphasis>,...]) 386 </term> 387 <listitem> 388 <para> 389This action ends a text selection that began with the <emphasis remap='I'>select-start</emphasis> 390action, and asserts ownership of the selection or selections specified. 391A <emphasis remap='I'>name</emphasis> can be a selection (e.g., <function>PRIMARY</function>) or a cut buffer 392(e.g., <function>CUT_BUFFER0</function>). Note that case is important. If no 393<emphasis remap='I'>names</emphasis> are specified, <function>PRIMARY</function> is asserted. 394 </para> 395 </listitem> 396 </varlistentry> 397 <varlistentry> 398 <term> 399 extend-start() 400 </term> 401 <listitem> 402 <para> 403This action finds the nearest end of the current selection, and moves it 404to the current pointer location (if triggered by a button event) or text 405cursor location (if triggered by a key event). 406 </para> 407 </listitem> 408 </varlistentry> 409 <varlistentry> 410 <term> 411 extend-adjust() 412 </term> 413 <listitem> 414 <para> 415This action allows a selection started with an <emphasis remap='I'>extend-start</emphasis> action 416to be modified. 417 </para> 418 </listitem> 419 </varlistentry> 420 <varlistentry> 421 <term> 422 extend-end(<emphasis remap='I'>name</emphasis>[,<emphasis remap='I'>name</emphasis>,...]) 423 </term> 424 <listitem> 425 <para> 426This action ends a text selection that began with the <emphasis remap='I'>extend-start</emphasis> 427action, and asserts ownership of the selection or selections specified. 428A <emphasis remap='I'>name</emphasis> can be a selection (e.g. <function>PRIMARY</function>) or a cut buffer 429(e.g <function>CUT_BUFFER0</function>). Note that case is important. If no names are 430given, <function>PRIMARY</function> is asserted. 431 </para> 432 </listitem> 433 </varlistentry> 434 <varlistentry> 435 <term> 436 insert-selection(<emphasis remap='I'>name</emphasis>[,<emphasis remap='I'>name</emphasis>,...]) 437 </term> 438 <listitem> 439 <para> 440This action retrieves the value of the first (left-most) named selection 441that exists or the cut buffer that is not empty and inserts it into the 442Text widget at the current insert point location. A <emphasis remap='I'>name</emphasis> can be a 443selection (e.g. <function>PRIMARY</function>) or a cut buffer (e.g <function>CUT_BUFFER0</function>). 444Note that case is important. 445 </para> 446 </listitem> 447 </varlistentry> 448</variablelist> 449</para> 450</sect2> 451<sect2 id="The_New_Line_Actions"> 452<title>The New Line Actions</title> 453<para> 454<!-- .LP --> 455<!-- .sp --> 456<variablelist> 457 <varlistentry> 458 <term> 459 newline-and-indent() 460 </term> 461 <listitem> 462 <para> 463This action inserts a newline into the text and adds spaces to 464that line to indent it to match the previous line. 465 </para> 466 </listitem> 467 </varlistentry> 468 <varlistentry> 469 <term> 470 newline-and-backup() 471 </term> 472 <listitem> 473 <para> 474This action inserts a newline into the text <emphasis remap='I'>after</emphasis> the insert point. 475 </para> 476 </listitem> 477 </varlistentry> 478 <varlistentry> 479 <term> 480 newline() 481 </term> 482 <listitem> 483 <para> 484This action inserts a newline into the text <emphasis remap='I'>before</emphasis> the insert point. 485 </para> 486 </listitem> 487 </varlistentry> 488</variablelist> 489</para> 490</sect2> 491<sect2 id="Kill_and_Actions"> 492<title>Kill and Actions</title> 493<para> 494<!-- .LP --> 495<!-- .sp --> 496<variablelist> 497 <varlistentry> 498 <term> 499 kill-word() 500 </term> 501 <listitem> 502 <para> 503<!-- .br --> 504<!-- .ns --> 505 </para> 506 </listitem> 507 </varlistentry> 508 <varlistentry> 509 <term> 510 backward-kill-word() 511 </term> 512 <listitem> 513 <para> 514These actions act exactly like the <emphasis remap='I'>delete-next-word</emphasis> and 515<emphasis remap='I'>delete-previous-word</emphasis> actions, but they stuff the word that was 516killed into the kill buffer (<function>CUT_BUFFER_1</function>). 517 </para> 518 </listitem> 519 </varlistentry> 520 <varlistentry> 521 <term> 522 kill-selection() 523 </term> 524 <listitem> 525 <para> 526This action deletes the current selection and stuffs the deleted text into 527the kill buffer (<function>CUT_BUFFER_1</function>). 528 </para> 529 </listitem> 530 </varlistentry> 531 <varlistentry> 532 <term> 533 kill-to-end-of-line() 534 </term> 535 <listitem> 536 <para> 537This action deletes the entire line to the right of the insert point position, 538and stuffs the deleted text into the kill buffer (<function>CUT_BUFFER_1</function>). 539 </para> 540 </listitem> 541 </varlistentry> 542 <varlistentry> 543 <term> 544 kill-paragraph() 545 </term> 546 <listitem> 547 <para> 548This action deletes the current paragraph, if between paragraphs it deletes 549the paragraph above the insert point, and stuffs the deleted text into 550the kill buffer (<function>CUT_BUFFER_1</function>). 551 </para> 552 </listitem> 553 </varlistentry> 554 <varlistentry> 555 <term> 556 kill-to-end-of-paragraph() 557 </term> 558 <listitem> 559 <para> 560This action deletes everything between the current insert point location and 561the next paragraph boundary, and stuffs the deleted text into the kill 562buffer (<function>CUT_BUFFER_1</function>). 563 </para> 564 </listitem> 565 </varlistentry> 566</variablelist> 567</para> 568</sect2> 569<sect2 id="Miscellaneous_Actions"> 570<title>Miscellaneous Actions</title> 571<para> 572<!-- .LP --> 573<!-- .sp 1 --> 574<variablelist> 575 <varlistentry> 576 <term> 577 redraw-display() 578 </term> 579 <listitem> 580 <para> 581This action recomputes the location of all the text lines on the 582display, scrolls the text to vertically center the line containing the insert point 583on the screen, clears the entire screen, and redisplays it. 584 </para> 585 </listitem> 586 </varlistentry> 587 <varlistentry> 588 <term> 589 insert-file([<emphasis remap='I'>filename</emphasis>]) 590 </term> 591 <listitem> 592 <para> 593This action activates the insert file popup. The <emphasis remap='I'>filename</emphasis> 594option specifies the default filename to put in the filename buffer of 595the popup. If no <emphasis remap='I'>filename</emphasis> is specified the buffer is empty 596at startup. 597 </para> 598 </listitem> 599 </varlistentry> 600 <varlistentry> 601 <term> 602 insert-char() 603 </term> 604 <listitem> 605 <para> 606This action may only be attached to a key event. When the 607<function>international</function> resource is <function>false</function>, this action 608calls XLookupString to translate the event into a (rebindable) Latin-1 609character (sequence) and inserts it into the text at the 610insert point. When the <function>international</function> resource is <function>true</function>, 611characters are passed to the input method via XwcLookupString, and any 612committed string returned is inserted into the text at the insert point. 613 </para> 614 </listitem> 615 </varlistentry> 616 <varlistentry> 617 <term> 618 insert-string(<emphasis remap='I'>string</emphasis>[,<emphasis remap='I'>string</emphasis>,...]) 619 </term> 620 <listitem> 621 <para> 622This action inserts each <emphasis remap='I'>string</emphasis> into the text 623at the insert point location. Any <emphasis remap='I'>string</emphasis> 624beginning with the characters "0x" followed by an even 625number of hexadecimal digits is 626interpreted as a hexadecimal constant and the 627corresponding string is inserted instead. This 628hexadecimal string may represent up to 50 8-bit characters. 629 When the<function>international</function> resource is 630<function>true</function>, a hexadecimal string is intrepeted as 631being in a multi-byte encoding, and a hexadecimal 632or regular string will result in an error message 633if it is not legal in the current locale. 634 </para> 635 </listitem> 636 </varlistentry> 637 <varlistentry> 638 <term> 639 display-caret(<emphasis remap='I'>state</emphasis>,<emphasis remap='I'>when</emphasis>) 640 </term> 641 <listitem> 642 <para> 643This action allows the insert point to be turned on and off. 644The <emphasis remap='I'>state</emphasis> argument specifies the desired state of the insert point. 645This value may be any of the string 646values accepted for Boolean resources (e.g. <function>on</function>, <function>True</function>, 647<function>off</function>, <function>False</function>, etc.). If no arguments are specified, the 648default value is <function>True</function>. 649The <emphasis remap='I'>when</emphasis> argument specifies, for <function>EnterNotify</function> or <function>LeaveNotify</function> 650events whether or not the focus field in the event is to be examined. 651If the second argument is not specified, or specified as something other 652than <function>always</function> then if the action is bound to an <function>EnterNotify</function> 653or <function>LeaveNotify</function> event, the action will be taken only if the focus 654field is <function>True</function>. An augmented binding that might be useful is: 655 </para> 656 </listitem> 657 </varlistentry> 658</variablelist> 659</para> 660<para> 661<!-- .LP --> 662<literallayout class="monospaced"> 663<!-- .TA 2.0i 2.5i 4.0i --> 664<!-- .ta 2.0i 2.5i 4.0i --> 665 *Text.Translations: #override \\ 666 <FocusIn>: display-caret(on) \\n\\ 667 <FocusOut>: display-caret(off) 668</literallayout> 669<variablelist> 670 <varlistentry> 671 <term> 672 focus-in() 673 </term> 674 <listitem> 675 <para> 676<!-- .br --> 677<!-- .ns --> 678 </para> 679 </listitem> 680 </varlistentry> 681 <varlistentry> 682 <term> 683 focus-out() 684 </term> 685 <listitem> 686 <para> 687These actions do not currently do anything. 688 </para> 689 </listitem> 690 </varlistentry> 691 <varlistentry> 692 <term> 693 search(<emphasis remap='I'>direction</emphasis>,[<emphasis remap='I'>string</emphasis>]) 694 </term> 695 <listitem> 696 <para> 697This action activates the search popup. The <emphasis remap='I'>direction</emphasis> must be 698specified as either <function>forward</function> or <function>backward</function>. The string is 699optional and is used as an initial value for the <emphasis remap='I'>Search for</emphasis>: string. 700For further explanation of the search widget see the section on 701<function>Text Searches</function>. 702 </para> 703 </listitem> 704 </varlistentry> 705 <varlistentry> 706 <term> 707 multiply(<emphasis remap='I'>value</emphasis>) 708 </term> 709 <listitem> 710 <para> 711The multiply action allows the user to multiply the effects of many of 712the text actions. Thus the following action sequence 713<emphasis remap='I'>multiply(10) delete-next-word()</emphasis> will delete 10 words. It does not 714matter whether these actions take place in one event or many events. 715Using the default translations the key sequence 716<emphasis remap='I'>Control-u, Control-d</emphasis> will delete 4 characters. 717Multiply actions can be chained, thus 718<emphasis remap='I'>multiply(5) multiply(5)</emphasis> is the same as 719<emphasis remap='I'>multiply(25)</emphasis>. If the string 720<function>reset</function> is passed to the multiply action the effects of all previous 721multiplies are removed and a beep is sent to the display. 722 </para> 723 </listitem> 724 </varlistentry> 725 <varlistentry> 726 <term> 727 form-paragraph() 728 </term> 729 <listitem> 730 <para> 731This action removes all the Carriage Returns from the current 732paragraph and reinserts them so that each line is as long as possible, while 733still fitting on the current screen. Lines are broken at word boundaries if 734at all possible. This action currently works only on Text widgets 735that use ASCII text. 736 </para> 737 </listitem> 738 </varlistentry> 739 <varlistentry> 740 <term> 741 transpose-characters() 742 </term> 743 <listitem> 744 <para> 745This action will swap the position of the character to the left of the 746insert point with the character to the right of the insert point. The insert point will then 747be advanced one character. 748 </para> 749 </listitem> 750 </varlistentry> 751 <varlistentry> 752 <term> 753 no-op([<emphasis remap='I'>action</emphasis>]) 754 </term> 755 <listitem> 756 <para> 757The no-op action makes no change to the text widget, and is mainly used 758to override translations. This action takes one optional argument. If 759this argument is <emphasis remap='I'>RingBell</emphasis> then a beep is sent to the display. 760 </para> 761 </listitem> 762 </varlistentry> 763 <varlistentry> 764 <term> 765 XawWMProtocols([<emphasis remap='I'>wm_protocol_name</emphasis>]) 766 </term> 767 <listitem> 768 <para> 769<indexterm><primary>XawWMProtocols</primary></indexterm> 770<!-- .sp --> 771This action is written specifically for the file insertion and the search 772and replace 773dialog boxes. This action is attached to those shells by the Text widget, 774in order to handle ClientMessage events with the WM_PROTOCOLS atom in the 775detail field. This action supports WM_DELETE_WINDOW on the Text widget 776popups, and may support other window manager protocols if necessary in 777the future. The popup will be dismissed if the window manager sends 778a WM_DELETE_WINDOW request and there are no parameters in the action 779call, which is the default. The popup will also be dismissed if the 780parameters include the string <quote>wm_delete_window,</quote> and the event is a 781ClientMessage event requesting dismissal or is not a ClientMessage event. 782This action is not sensitive to the case of the strings passed as parameters. 783 </para> 784 </listitem> 785 </varlistentry> 786 <varlistentry> 787 <term> 788 reconnect-im() 789 </term> 790 <listitem> 791 <para> 792<indexterm><primary>Input Method</primary></indexterm> 793When the <function>international</function> resource is <function>true</function>, 794input is usually passed to an input method, a separate 795process, for composing. Sometimes the connection to 796this process gets severed; this action will attempt to 797reconnect it. Causes for severage include network 798trouble, and the user explicitly killing one input 799method and starting a new one. This action may also 800establish first connection when the application is 801started before the input method. 802 </para> 803 </listitem> 804 </varlistentry> 805</variablelist> 806</para> 807</sect2> 808<sect2 id="Text_Selections_for_Application_Programmers"> 809<title>Text Selections for Application Programmers</title> 810<indexterm><primary>Text widget</primary><secondary>Text Selections for Application Programmers</secondary></indexterm> 811<para> 812<!-- .LP --> 813The default behavior of the text selection array is described in the 814section called <function>Text Selections for Users</function>. To modify the selections 815a programmer must construct a <function>XawTextSelectType</function> array (called the 816selection array), containing the selections desired, and pass this as 817the new value for the <function>selectionTypes</function> resource. The selection 818array may also be modified using the <xref linkend='XawTextSetSelectionArray' xrefstyle='select: title'/> 819<indexterm><primary>XawTextSetSelectionArray</primary></indexterm> 820function. All selection arrays must end with the value 821<function>XawselectNull</function>. The <function>selectionTypes</function> resource has no converter 822registered and cannot be modified through the resource manager. 823</para> 824<para> 825<!-- .LP --> 826The array contains a list of entries that will be called when the user 827attempts to select text in rapid succession with the <emphasis remap='I'>select-start</emphasis> 828action (usually by clicking a pointer button). The first entry in the 829selection array will be used when the <emphasis remap='I'>select-start</emphasis> action is 830initially called. The next entry will be used when <emphasis remap='I'>select-start</emphasis> 831is called again, and so on. If a timeout value (1/10 of a second) is 832exceeded, the the next <emphasis remap='I'>select-start</emphasis> action will begin at the top 833of the selection array. When <function>XawselectNull</function> is reached the array 834is recycled beginning with the first element. 835 836<informaltable> 837 <tgroup cols='2' align='center'> 838 <colspec colname='c1'/> 839 <colspec colname='c2'/> 840 <tbody> 841 <row> 842 <entry><function>XawselectAll</function></entry> 843 <entry>Selects the contents of the entire buffer.</entry> 844 </row> 845 <row> 846 <entry><function>XawselectChar</function></entry> 847 <entry>Selects text characters as the pointer moves over them.</entry> 848 </row> 849 <row> 850 <entry><function>XawselectLine</function></entry> 851 <entry>Selects the entire line.</entry> 852 </row> 853 <row> 854 <entry><function>XawselectNull</function></entry> 855 <entry>Indicates the end of the selection array.</entry> 856 </row> 857 <row> 858 <entry><function>XawselectParagraph</function></entry> 859 <entry>Selects the entire paragraph.</entry> 860 </row> 861 <row> 862 <entry><function>XawselectPosition</function></entry> 863 <entry>Selects the current pointer position.</entry> 864 </row> 865 <row> 866 <entry><function>XawselectWord</function></entry> 867 <entry>Selects whole words as the pointer moves onto them.</entry> 868 </row> 869 </tbody> 870 </tgroup> 871</informaltable> 872</para> 873<para> 874<!-- .LP --> 875The default selectType array is: 876</para> 877<para> 878<!-- .LP --> 879<!-- .sp --> 880<literallayout class="monospaced"> 881{XawselectPosition, XawselectWord, XawselectLine, XawselectParagraph, XawselectAll, XawselectNull} 882</literallayout> 883<!-- .sp --> 884</para> 885<para> 886<!-- .LP --> 887The selection array is not copied by the text widgets. The 888application must allocate space for the array and cannot deallocate or 889change it until the text widget is destroyed or until a new selection 890array is set. 891</para> 892</sect2> 893</sect1> 894