ViewVC Help
View File | Revision Log | Show Annotations | Download File
/cvs/rxvt-unicode/src/urxvt.pm
(Generate patch)

Comparing rxvt-unicode/src/urxvt.pm (file contents):
Revision 1.84 by root, Thu Jan 12 02:20:56 2006 UTC vs.
Revision 1.86 by root, Thu Jan 12 05:22:47 2006 UTC

230=item on_sel_extend $term 230=item on_sel_extend $term
231 231
232Called whenever the user tries to extend the selection (e.g. with a double 232Called whenever the user tries to extend the selection (e.g. with a double
233click) and is either supposed to return false (normal operation), or 233click) and is either supposed to return false (normal operation), or
234should extend the selection itelf and return true to suppress the built-in 234should extend the selection itelf and return true to suppress the built-in
235processing. 235processing. This can happen multiple times, as long as the callback
236returns true, it will be called on every further click by the user and is
237supposed to enlarge the selection more and more, if possible.
236 238
237See the F<selection> example extension. 239See the F<selection> example extension.
238 240
239=item on_view_change $term, $offset 241=item on_view_change $term, $offset
240 242
595 if ($@) { 597 if ($@) {
596 $TERM->ungrab; # better to lose the grab than the session 598 $TERM->ungrab; # better to lose the grab than the session
597 warn $@; 599 warn $@;
598 } 600 }
599 } 601 }
602
603 verbose 11, "$HOOKNAME[$htype] returning <$retval>"
604 if $verbosity >= 11;
600 } 605 }
601 606
602 if ($htype == 1) { # DESTROY 607 if ($htype == 1) { # DESTROY
603 if (my $hook = delete $TERM->{_hook}) { 608 if (my $hook = delete $TERM->{_hook}) {
604 for my $htype (0..$#$hook) { 609 for my $htype (0..$#$hook) {
910=item ($row, $col) = $term->selection_end ([$row, $col]) 915=item ($row, $col) = $term->selection_end ([$row, $col])
911 916
912Return the current values of the selection mark, begin or end positions, 917Return the current values of the selection mark, begin or end positions,
913and optionally set them to new values. 918and optionally set them to new values.
914 919
920=item $term->selection_make ($eventtime[, $rectangular])
921
922Tries to make a selection as set by C<selection_beg> and
923C<selection_end>. If C<$rectangular> is true (default: false), a
924rectangular selection will be made. This is the prefered function to make
925a selection.
926
915=item $success = $term->selection_grab ($eventtime) 927=item $success = $term->selection_grab ($eventtime)
916 928
917Try to request the primary selection from the server (for example, as set 929Try to request the primary selection text from the server (for example, as
918by the next method). 930set by the next method). No visual feedback will be given. This function
931is mostly useful from within C<on_sel_grab> hooks.
919 932
920=item $oldtext = $term->selection ([$newtext]) 933=item $oldtext = $term->selection ([$newtext])
921 934
922Return the current selection text and optionally replace it by C<$newtext>. 935Return the current selection text and optionally replace it by C<$newtext>.
923 936
1016Convert the given locale-encoded octets into a perl string. 1029Convert the given locale-encoded octets into a perl string.
1017 1030
1018=item $term->scr_xor_span ($beg_row, $beg_col, $end_row, $end_col[, $rstyle]) 1031=item $term->scr_xor_span ($beg_row, $beg_col, $end_row, $end_col[, $rstyle])
1019 1032
1020XORs the rendition values in the given span with the provided value 1033XORs the rendition values in the given span with the provided value
1021(default: C<RS_RVid>). Useful in refresh hooks to provide effects similar 1034(default: C<RS_RVid>), which I<MUST NOT> contain font styles. Useful in
1022to the selection. 1035refresh hooks to provide effects similar to the selection.
1023 1036
1024=item $term->scr_xor_rect ($beg_row, $beg_col, $end_row, $end_col[, $rstyle1[, $rstyle2]]) 1037=item $term->scr_xor_rect ($beg_row, $beg_col, $end_row, $end_col[, $rstyle1[, $rstyle2]])
1025 1038
1026Similar to C<scr_xor_span>, but xors a rectangle instead. Trailing 1039Similar to C<scr_xor_span>, but xors a rectangle instead. Trailing
1027whitespace will additionally be xored with the C<$rstyle2>, which defaults 1040whitespace will additionally be xored with the C<$rstyle2>, which defaults
1028to C<RS_RVid | RS_Uline>, which removes reverse video again and underlines 1041to C<RS_RVid | RS_Uline>, which removes reverse video again and underlines
1029it instead. 1042it instead. Both styles I<MUST NOT> contain font styles.
1030 1043
1031=item $term->scr_bell 1044=item $term->scr_bell
1032 1045
1033Ring the bell! 1046Ring the bell!
1034 1047
1218Return the row number of the first/last row of the line, respectively. 1231Return the row number of the first/last row of the line, respectively.
1219 1232
1220=item $offset = $line->offset_of ($row, $col) 1233=item $offset = $line->offset_of ($row, $col)
1221 1234
1222Returns the character offset of the given row|col pair within the logical 1235Returns the character offset of the given row|col pair within the logical
1223line. 1236line. Works for rows outside the line, too, and returns corresponding
1237offsets outside the string.
1224 1238
1225=item ($row, $col) = $line->coord_of ($offset) 1239=item ($row, $col) = $line->coord_of ($offset)
1226 1240
1227Translates a string offset into terminal coordinates again. 1241Translates a string offset into terminal coordinates again.
1228 1242
1583 1597
1584=item == 0 - fatal messages 1598=item == 0 - fatal messages
1585 1599
1586=item >= 3 - script loading and management 1600=item >= 3 - script loading and management
1587 1601
1588=item >=10 - all events received 1602=item >=10 - all called hooks
1603
1604=item >=11 - hook reutrn values
1589 1605
1590=back 1606=back
1591 1607
1592=head1 AUTHOR 1608=head1 AUTHOR
1593 1609

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines