.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\"
.\" Required to disable full justification in groff 1.23.0.
.if n .ds AD l
.\" ========================================================================
.\"
.IX Title "urxvt-selection-popup 1"
.TH urxvt-selection-popup 1 2025-10-24 9.31 RXVT-UNICODE
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "نام (NAME)"
urxvt\-selection\-popup \- منوی بازشوی مدیریت متن انتخاب‌شده
.SH "توضیحات (DESCRIPTION)"
.IX Header "DESCRIPTION"
یک منوی بازشو را به
.B Ctrl\-Button3
متصل می‌کند که به شما امکان می‌دهد گزینش‌های سامانه X را جای‌گذاری (paste) کرده و بسته به محتوا، متن انتخاب‌شده داخلی را به روش‌های گوناگون (مانند تبدیل کدهای اسکیپ URI به حالت اولیه، ارزیابی در Perl، باز کردن در مرورگر وب و غیره) تغییر دهید یا از آن استفاده کنید.
.PP
سایر افزونه‌ها می‌توانند با افزودن یک ارجاع کد (code reference) به
\f(CW\*(C`@{ $term\->{selection_popup_hook} }\*(C'\fR
این منوی بازشو را گسترش دهند؛ این قلاب هر بار که منوی بازشو نمایش داده شود فراخوانی می‌گردد.
.PP
تنها آرگومان آن، منوی بازشو است که قابلیت تغییر دارد. متن انتخاب‌شده در
\f(CW$_\fR
قرار دارد که می‌توان از آن برای تصمیم‌گیری در مورد افزودن یا نیافزودن گزینه‌ها استفاده کرد.
این تابع باید یا هیچ مقداری بازنگرداند، یا یک رشته متنی و یک ارجاع کد برگرداند. این رشته به عنوان متن دکمه استفاده خواهد شد و ارجاع کد هنگام فعال شدن دکمه فراخوانی می‌شود و باید
\f(CW$_\fR
را دگرگون کند.
.PP
کد زیر یک مدخل با عنوان
\f(CW\*(C`a to b\*(C'\fR
اضافه می‌کند که تمام
\f(CW\*(C`a\*(C'\fRها
را در متن انتخاب‌شده به
\f(CW\*(C`b\*(C'\fR
تبدیل می‌کند، اما تنها در صورتی که متن انتخاب‌شده در حال حاضر شامل نویسه
\&\f(CW\*(C`a\*(C'\fR
باشد:
.PP
.Vb 4
\&   push @{ $self\->{term}{selection_popup_hook} }, sub {
\&      /a/ ? ("a to b" => sub { s/a/b/g }
\&          : ()
\&   };
.Ve