… | |
… | |
205 | |
205 | |
206 | It is called before lines are scrolled out (so rows 0 .. min ($lines - 1, |
206 | It is called before lines are scrolled out (so rows 0 .. min ($lines - 1, |
207 | $nrow - 1) represent the lines to be scrolled out). C<$saved> is the total |
207 | $nrow - 1) represent the lines to be scrolled out). C<$saved> is the total |
208 | number of lines that will be in the scrollback buffer. |
208 | number of lines that will be in the scrollback buffer. |
209 | |
209 | |
210 | =item on_tty_activity $term *NYI* |
|
|
211 | |
|
|
212 | Called whenever the program(s) running in the urxvt window send output. |
|
|
213 | |
|
|
214 | =item on_osc_seq $term, $string |
210 | =item on_osc_seq $term, $string |
215 | |
211 | |
216 | Called whenever the B<ESC ] 777 ; string ST> command sequence (OSC = |
212 | Called whenever the B<ESC ] 777 ; string ST> command sequence (OSC = |
217 | operating system command) is processed. Cursor position and other state |
213 | operating system command) is processed. Cursor position and other state |
218 | information is up-to-date when this happens. For interoperability, the |
214 | information is up-to-date when this happens. For interoperability, the |
… | |
… | |
336 | newline. The module also overwrites the C<warn> builtin with a function |
332 | newline. The module also overwrites the C<warn> builtin with a function |
337 | that calls this function. |
333 | that calls this function. |
338 | |
334 | |
339 | Using this function has the advantage that its output ends up in the |
335 | Using this function has the advantage that its output ends up in the |
340 | correct place, e.g. on stderr of the connecting urxvtc client. |
336 | correct place, e.g. on stderr of the connecting urxvtc client. |
|
|
337 | |
|
|
338 | =item $is_safe = urxvt::safe |
|
|
339 | |
|
|
340 | Returns true when it is safe to do potentially unsafe things, such as |
|
|
341 | evaluating perl code specified by the user. This is true when urxvt was |
|
|
342 | started setuid or setgid. |
341 | |
343 | |
342 | =item $time = urxvt::NOW |
344 | =item $time = urxvt::NOW |
343 | |
345 | |
344 | Returns the "current time" (as per the event loop). |
346 | Returns the "current time" (as per the event loop). |
345 | |
347 | |
… | |
… | |
1100 | $offset / $self->{ncol} + $self->{beg}, |
1102 | $offset / $self->{ncol} + $self->{beg}, |
1101 | $offset % $self->{ncol} |
1103 | $offset % $self->{ncol} |
1102 | ) |
1104 | ) |
1103 | } |
1105 | } |
1104 | |
1106 | |
1105 | =item ($row, $col) = $line->coord_of ($offset) |
|
|
1106 | =item $text = $term->special_encode $string |
1107 | =item $text = $term->special_encode $string |
1107 | |
1108 | |
1108 | Converts a perl string into the special encoding used by rxvt-unicode, |
1109 | Converts a perl string into the special encoding used by rxvt-unicode, |
1109 | where one character corresponds to one screen cell. See |
1110 | where one character corresponds to one screen cell. See |
1110 | C<< $term->ROW_t >> for details. |
1111 | C<< $term->ROW_t >> for details. |
1111 | |
1112 | |
1112 | =item $string = $term->special_decode $text |
1113 | =item $string = $term->special_decode $text |
1113 | |
1114 | |
1114 | Converts rxvt-unicodes text reprsentation into a perl string. See |
1115 | Converts rxvt-unicodes text reprsentation into a perl string. See |
1115 | C<< $term->ROW_t >> for details. |
1116 | C<< $term->ROW_t >> for details. |
|
|
1117 | |
|
|
1118 | =item $success = $term->grab_button ($button, $modifiermask) |
|
|
1119 | |
|
|
1120 | Registers a synchronous button grab. See the XGrabButton manpage. |
|
|
1121 | |
|
|
1122 | =item $success = $term->grab ($eventtime[, $sync]) |
|
|
1123 | |
|
|
1124 | Calls XGrabPointer and XGrabKeyboard in asynchronous (default) or |
|
|
1125 | synchronous (C<$sync> is true). Also remembers the grab timestampe. |
|
|
1126 | |
|
|
1127 | =item $term->allow_events_async |
|
|
1128 | |
|
|
1129 | Calls XAllowEvents with AsyncBoth for the most recent grab. |
|
|
1130 | |
|
|
1131 | =item $term->allow_events_sync |
|
|
1132 | |
|
|
1133 | Calls XAllowEvents with SyncBoth for the most recent grab. |
|
|
1134 | |
|
|
1135 | =item $term->allow_events_replay |
|
|
1136 | |
|
|
1137 | Calls XAllowEvents with both ReplayPointer and ReplayKeyboard for the most |
|
|
1138 | recent grab. |
|
|
1139 | |
|
|
1140 | =item $term->ungrab |
|
|
1141 | |
|
|
1142 | Calls XUngrab for the most recent grab. Is called automatically on |
|
|
1143 | evaluation errors, as it is better to lose the grab in the error case as |
|
|
1144 | the session. |
1116 | |
1145 | |
1117 | =back |
1146 | =back |
1118 | |
1147 | |
1119 | =cut |
1148 | =cut |
1120 | |
1149 | |
… | |
… | |
1162 | } |
1191 | } |
1163 | |
1192 | |
1164 | sub add_button { |
1193 | sub add_button { |
1165 | my ($self, $text, $cb) = @_; |
1194 | my ($self, $text, $cb) = @_; |
1166 | |
1195 | |
1167 | $self->add_item ({ type => "button", text => "[ $text ]", activate => $cb}); |
1196 | $self->add_item ({ type => "button", text => $text, activate => $cb}); |
1168 | } |
1197 | } |
1169 | |
1198 | |
1170 | sub add_toggle { |
1199 | sub add_toggle { |
1171 | my ($self, $text, $cb, $value) = @_; |
1200 | my ($self, $text, $cb, $value) = @_; |
1172 | |
1201 | |
… | |
… | |
1186 | |
1215 | |
1187 | local $urxvt::popup::self = $self; |
1216 | local $urxvt::popup::self = $self; |
1188 | |
1217 | |
1189 | urxvt->new ("--perl-lib" => "", "--perl-ext-common" => "", "-pty-fd" => -1, "-sl" => 0, "-b" => 0, |
1218 | urxvt->new ("--perl-lib" => "", "--perl-ext-common" => "", "-pty-fd" => -1, "-sl" => 0, "-b" => 0, |
1190 | "--transient-for" => $self->{term}->parent, |
1219 | "--transient-for" => $self->{term}->parent, |
|
|
1220 | "-display" => $self->{term}->display_id, |
1191 | "-pe" => "urxvt-popup") |
1221 | "-pe" => "urxvt-popup") |
1192 | or die "unable to create popup window\n"; |
1222 | or die "unable to create popup window\n"; |
1193 | } |
1223 | } |
1194 | |
1224 | |
1195 | sub DESTROY { |
1225 | sub DESTROY { |