YAD(1) User Commands YAD(1)

yad - نمایش کادرهای محاوره‌ای GTK+ از طریق اسکریپت‌های شل یا خط فرمان

yad [OPTIONS]

برنامه YAD ابزاری است که کادرهای محاوره‌ای GTK+ را نمایش داده و ورودی کاربر را (در قالب کد بازگشتی یا در خروجی استاندارد) برمی‌گرداند. این قابلیت به شما امکان می‌دهد در انواع اسکریپت‌های شل، اطلاعات را به کاربر نمایش داده یا از او ورودی دریافت کنید.

برنامه YAD یک انشعاب (fork) از برنامه Zenity است.

این برنامه از نحو معمول خط فرمان گنو (GNU) پیروی می‌کند، به این صورت که گزینه‌های طولانی با دو خط تیره ('-') آغاز می‌شوند.

نمایش کادر محاوره‌ای درباره برنامه.
نمایش کادر محاوره‌ای انتخاب برنامه.
نمایش کادر محاوره‌ای تقویم.
نمایش کادر محاوره‌ای انتخاب رنگ.
نمایش کادر کشیدن و رها کردن (drag-and-drop).
نمایش کادر محاوره‌ای ورودی متن.
نمایش جعبه‌ای از آیکون‌های میان‌بر.
نمایش کادر محاوره‌ای انتخاب فایل.
نمایش کادر محاوره‌ای انتخاب قلم (فونت).
نمایش کادر محاوره‌ای فرم.
نمایش کادر محاوره‌ای HTML.
نمایش کادر محاوره‌ای فهرست.
نمایش کادر محاوره‌ای چندبرگ (notebook).
نمایش آیکون اعلان (notification).
نمایش آیکون appindicator.
نمایش کادر محاوره‌ای پیام بالاپر (popup).
نمایش کادر محاوره‌ای چاپ.
نمایش کادر محاوره‌ای نشانگر پیشرفت.
نمایش کادر محاوره‌ای مقیاس (اسلایدر).
نمایش کادر محاوره‌ای اطلاعات متنی..SS "گزینه‌های عمومی (General options)"
تنظیم عنوان کادر محاوره.
تنظیم آیکون پنجره.
تنظیم عرض پنجرهٔ کادر محاوره.
تنظیم ارتفاع پنجرهٔ کادر محاوره.
تنظیم موقعیت افقی (X) پنجرهٔ کادر محاوره. NUMBER می‌تواند منفی باشد.
تنظیم موقعیت عمودی (Y) پنجرهٔ کادر محاوره. NUMBER می‌تواند منفی باشد.
استفاده از نمادگذاری استاندارد هندسهٔ X Window برای تعیین محل کادر محاوره. هنگامی که از این گزینه استفاده شود، گزینه‌های width، height، posx، posy، mouse و center نادیده گرفته می‌شوند.
تنظیم زمان انقضای کادر محاوره به ثانیه.
نمایش نشانگر زمان انقضا در موقعیت داده‌شده. موقعیت‌ها عبارتند از: top، bottom، left یا right. ظاهر نشانگر می‌تواند از طریق شیوه‌نامه‌های CSS کاربر تنظیم شود.
ارسال SIGNAL به فرایند والد. مقدار پیش‌فرض SIGNAL برابر با SIGTERM است. SIGNAL می‌تواند با شماره یا نام نمادین آن با پیشوند SIG یا بدون آن مشخص شود. برای جزئیات بیشتر در مورد سیگنال‌ها signal(7) را ببینید.
خروجی دادن شناسهٔ پنجرهٔ X Window کادر yad به فایل مشخص‌شده یا stderr.
اجرای کادر محاوره در حالت plug جهت جاگذاری به عنوان یک تب notebook. برای اطلاعات بیشتر بخش NOTEBOOK را ببینید.
تنظیم شمارهٔ تب برای کادر محاورهٔ متصل‌شده (plugged). برای اطلاعات بیشتر بخش NOTEBOOK را ببینید.
تنظیم متن کادر محاوره.
تنظیم حداکثر عرض متن کادر محاوره بر حسب نویسه.
تنظیم نوع تراز متن کادر محاوره. TYPE می‌تواند left، right، center یا fill باشد.
تنظیم تصویر کادر محاوره که در سمت چپ متن آن نمایش داده می‌شود. IMAGE می‌تواند نام یک فایل یا نام یک آیکون از تم آیکون فعلی باشد.
استفاده از تم آیکون GTK مشخص‌شده به جای مقدار پیش‌فرض.
آیکون‌ها مقیاس‌بندی نشوند. این گزینه بر آیکون‌های خارج از تم آیکون تأثیر می‌گذارد.
پنهان کردن ویجت اصلی با یک گسترش‌دهنده (expander). TEXT یک آرگومان اختیاری برای برچسب expander است.
افزودن دکمه به کادر محاوره. می‌تواند چندین بار استفاده شود. ID یک کد خروج یا یک دستور است. BUTTON می‌تواند نام یک آیتم استاندارد (stock item) در yad برای دکمه‌های از پیش تعریف‌شده (مانند yad-close یا yad-ok) باشد، یا متنی در قالب LABEL[!ICON[!TOOLTIP]] که در آن `!' جداکنندهٔ بخش‌ها است. فهرست کامل موارد پیش‌ساخته را می‌توان در بخش STOCK ITEMS یافت. اگر هیچ دکمه‌ای مشخص نشود، دکمه‌های OK و Cancel استفاده می‌شوند. برای اطلاعات بیشتر بخش EXIT STATUS را ببینید. اگر ID مقداری غیرعددی داشته باشد، به عنوان یک دستور در نظر گرفته می‌شود و کلیک بر روی چنین دکمه‌ای کادر محاوره را نمی‌بندد.
دکمه‌ها نمایش داده نشوند.
تنظیم نوع چیدمان دکمه‌ها. انواع ممکن عبارتند از: spread، edge، start، end یا center. پیش‌فرض end است.
عدم استفاده از نشانه‌گذاری pango در متن کادر محاوره.
در صورت فشرده شدن کلید Escape، کادر محاوره بسته نشود.
کلید Escape مانند فشردن دکمهٔ OK عمل کند.
چاپ نتیجه برای هر یک از کدهای بازگشتی. این گزینه در صورتی که زمان انقضا به پایان برسد یا کلید Escape فشرده شود، کار نمی‌کند.
همهٔ دستورها تحت مفسر مشخص‌شده اجرا شوند. مقدار پیش‌فرض bash -c "%s" است. این گزینه می‌تواند نیاز به نقل‌قول (quoting) را در دستورها کاهش دهد. اگر %s مشخص شده باشد، با دستور جایگزین خواهد شد. در غیر این صورت، دستور به انتهای خط فرمان افزوده می‌شود.
استفاده از CMD به عنوان گردانندهٔ uri. به طور پیش‌فرض yad از پارامتر open-command در تنظیمات استفاده می‌کند. مقدار URI جایگزین %s در رشتهٔ دستور می‌شود یا به عنوان آخرین بخش به خط فرمان اضافه می‌گردد.
تنظیم دستوری که هنگام فشردن کلید F1 اجرا می‌شود.
تنظیم دایرکتوری کاری فعلی به PATH.
تنظیم حاشیه‌های پنجرهٔ کادر محاوره.
نمایش پنجره در تمام میزکارهای کاری (desktops).
ثابت نگه داشتن عرض و ارتفاع پنجره.
قرار دادن پنجره در مرکز صفحهٔ نمایش.
قرار دادن پنجره زیر موقعیت اشاره‌گر موش (ماوس).
قرار دادن پنجره روی سایر پنجره‌ها.
بدون تزیین کردن پنجره (حذف عنوان و کادرهای پنجره).
عدم نمایش پنجره در نوار وظیفه (taskbar) و پیجر (pager).
اجرای پنجرهٔ کادر محاوره در حالت بیشینه (maximized).
اجرای کادر محاوره در حالت تمام‌صفحه. این گزینه ممکن است روی همهٔ مدیران پنجره کار نکند.
ایجاد یک پنجره با نوع پنجرهٔ مشخص‌شده. TYPE می‌تواند یکی از موارد normal، dialog، utility، dock، desktop، tooltip، notification یا splash باشد. رفتار هر نوع پنجره به مدیر پنجرهٔ شما بستگی دارد. برای جزئیات به مشخصات EWMH مراجعه کنید.

نکته: مدیران پنجرهٔ کاشی‌ساز (tiling window managers) اغلب یک پنجرهٔ "dialog" را شناور (float) اما یک پنجرهٔ "normal" را کاشی‌بندی (tile) می‌کنند.

پنجرهٔ کادر محاوره هرگز فوکوس را دریافت نکند.
بستن پنجرهٔ کادر محاوره هنگامی که فوکوس را از دست می‌دهد.
در صورت تنظیم، کاربر می‌تواند متن کادر محاوره را انتخاب کرده و در کلیپ‌بورد کپی کند. این گزینه همچنین بر فیلدهای برچسب در کادر محاورهٔ فرم (form) اثر می‌گذارد.
افزودن مسیر مشخص‌شده به فهرست استاندارد دایرکتوری‌ها جهت جستجوی آیکون‌ها. این گزینه می‌تواند چندین بار استفاده شود.
خواندن آرگومان‌های اضافی از فایل داده‌شده به جای خط فرمان. با هر خط از فایل به عنوان یک آرگومان مستقل رفتار می‌شود.
تنظیم کد خروج پیش‌فرض به NUMBER به جای 0.
خواندن و تجزیهٔ شیوه‌نامه‌های اضافی CSS در GTK+ از دادهٔ ارائه‌شده. اگر STRING یک نام فایل باشد، محتوای فایل بارگذاری می‌شود. در غیر این صورت با STRING مانند داده‌های CSS برخورد می‌شود.
خواندن و تجزیهٔ شیوه‌نامه‌های اضافی CSS در GTK+ از فایل داده‌شده. این گزینه منسوخ شده است. به جای آن از --css استفاده کنید.
تنظیم نوع خط‌مشی نوارهای پیمایش افقی. TYPE می‌تواند یکی از مقادیر auto، always یا never باشد. پیش‌فرض auto است.
تنظیم نوع خط‌مشی نوارهای پیمایش عمودی. TYPE می‌تواند یکی از مقادیر auto، always یا never باشد. پیش‌فرض auto است.
فعال کردن غلط‌یابی املایی در ویجت‌های textview.
تنظیم زبان غلط‌یابی املایی به LANGUAGE. به طور پیش‌فرض، زبان از لوکال (locale) فعلی حدس زده می‌شود. برای دریافت فهرست همهٔ زبان‌های ممکن از yad-tools(1) استفاده کنید..TP --bool-fmt=TYPE تنظیم نوع خروجی مقادیر بولی به TYPE. انواع ممکن عبارتند از T، t، Y، y، O، o و 1.
T و t - برای جفت true/false با حروف بزرگ/کوچک متناظر.
Y و y - برای جفت yes/no با حروف بزرگ/کوچک متناظر.
O و o - برای جفت on/off با حروف بزرگ/کوچک متناظر.
1 - برای جفت 1/0.
نوشتن تنظیمات yad در یک فایل. بخش SETTINGS را ببینید.

تنظیم نام برنامه.
تنظیم نام آیکون برنامه.
تنظیم رشته نسخه برنامه.
تنظیم رشته حق نشر (کپی‌رایت) برنامه.
تنظیم توضیحات تفصیلی برنامه.
تنظیم پروانه برنامه. مقدار این گزینه می‌تواند یکی از پروانه‌های از پیش تعریف‌شده (GPL2، GPL3، LGPL2، LGPL3، BSD، MIT یا ARTISTIC)، نام فایلی حاوی متن پروانه یا یک رشته دلخواه باشد.
تنظیم فهرست نویسندگان برنامه که با کاما از یکدیگر جدا شده‌اند.
تنظیم پیوندی به وب‌سایت برنامه.
تنظیم برچسب پیوند وب‌سایت برنامه.

نمایش برنامه‌های جایگزین (fallback).
نمایش سایر برنامه‌ها.
نمایش تمام برنامه‌های موجود.
نمایش اطلاعات گسترده درباره برنامه انتخاب‌شده. به‌طور پیش‌فرض تنها فایل اجرایی نمایش داده می‌شود. در حالت گسترده، فیلدهای خروجی عبارتند از نام، نام نمایشی، توضیحات، آیکون و فایل اجرایی.

آرگومان اضافی برای کادر گفتگوی برنامه، یک mime-type است. اگر mime-type مشخص نشود، از text/plain استفاده خواهد شد.

تنظیم روز تقویم.
تنظیم ماه تقویم.
تنظیم سال تقویم.
تنظیم قالب تاریخ بازگردانده‌شده. مقدار پیش‌فرض '%x' است. برای جزئیات بیشتر strftime(3) را ببینید.
نمایش شماره هفته‌ها در سمت چپ تقویم.
خواندن توضیحات روزها از FILENAME.

فایل حاوی جزئیات روزها باید در قالب زیر باشد:

<date> <description>

فیلد date تاریخی در قالب مشخص‌شده با گزینه --date-format است. فیلد description رشته‌ای شامل جزئیات تاریخ است که می‌تواند حاوی نشانه‌گذاری Pango باشد.

اجرای دستور مشخص‌شده هنگام انتخاب تاریخ. تاریخ انتخاب‌شده در قالب YEAR MONTH DAY به انتهای دستور اضافه می‌شود..SS گزینه‌های انتخاب رنگ
تنظیم مقدار رنگ اولیه.
نمایش پالت سامانه درون گفتگوی رنگ. برای ساخت‌های GTK+3 این گزینه به جای ویرایشگر رنگ، پالت را نمایش می‌دهد.
افزودن دکمه انتخابگر رنگ از صفحه (قطره‌چکان).
افزودن میزان کدر بودن (opacity) به رشته رنگ خروجی.
نمایش پالت و تنظیم رنگ‌های از پیش تعریف‌شده از نام فایل ارائه‌شده. به‌طور پیش‌فرض yad از فایل /etc/X11/rgb.txt استفاده می‌کند.
بازکننده (expander) فهرست رنگ‌های تعریف‌شده توسط کاربر در ابتدا باز خواهد بود.
تنظیم حالت رنگ خروجی. مقادیر ممکن hex یا rgb هستند. پیش‌فرض hex است. حالت HEX به صورت #rrggbbaa و حالت RGB به صورت rgba(r, g, b, a) است. در حالت RGBA، میزان کدر بودن مقداری بین 0.0 تا 1.0 دارد.

استفاده از متن گفتگو به عنوان راهنمای متنی (tooltip) برای کادر کشیدن و رها کردن.
اجرای دستور هنگام دریافت داده. رشته‌های داده به عنوان یک آرگومان به دستور ارسال می‌شوند یا جایگزین اصلاح‌کننده %s در دستور می‌شوند. به‌طور پیش‌فرض داده‌ها صرفاً روی stdout چاپ می‌شوند.
خروج پس از اینکه تعداد رها کردن‌ها به NUMBER رسید. مقدار 0 به معنای تعداد نامحدود رها کردن است؛ این حالت پیش‌فرض است.

تنظیم متن برچسب ورودی.
تنظیم متن اولیه ورودی یا مورد پیش‌فرض در جعبه ترکیبی (combo-box).
پنهان کردن متن ورودی.
استفاده از تکمیل خودکار به جای جعبه ترکیبی.
استفاده از نوع مشخص برای تکمیل گسترده. TYPE می‌تواند any برای تطابق با هر یک از کلمات تایپ‌شده، all برای تطابق با تمام کلمات تایپ‌شده یا regex در حالتی باشد که با متن تایپ‌شده به عنوان یک عبارت باقاعده برخورد می‌شود.
اجازه اعمال تغییرات در متن جعبه ترکیبی.
استفاده از دکمه چرخشی (spin button) به جای ورودی متن. پارامترهای اضافی در خط فرمان (به همان ترتیب) به عنوان مقادیر کمینه و بیشینه، مقدار گام و دقت اعشار در نظر گرفته می‌شوند. تمام این مقادیر اختیاری هستند. محدوده پیش‌فرض از 0 تا 65535 با گام 1 است.
تنظیم دقت اعداد اعشاری ممیز شناور. به‌طور پیش‌فرض دقت سه رقم پس از ممیز است.
تنظیم یک آیکون در سمت چپ ورودی.
تعیین دستوری که هنگام کلیک روی آیکون سمت چپ اجرا خواهد شد. خروجی دستور به عنوان متن ورودی تنظیم می‌شود.
تنظیم یک آیکون در سمت راست ورودی.
تعیین دستوری که هنگام کلیک روی آیکون سمت راست اجرا خواهد شد. خروجی دستور به عنوان متن ورودی تنظیم می‌شود.
ارسال نمایه (index) عنصر فعال به خروجی به جای متن، برای ورودی جعبه ترکیبی.

هر داده اضافی که در خط فرمان مشخص شود، به عنوان مواردی از ورودی جعبه ترکیبی افزوده می‌شود، به جز در حالت عددی.

اگر آیکون مشخص شده باشد اما عملیاتی برای آن تعیین نشده باشد، کلیک روی آیکون صرفاً ورودی را پاک می‌کند. فیلدهای عددی آیکون‌ها را نادیده خواهند گرفت..SS گزینه‌های جعبه‌آیکون (Iconbox options)

خواندن فایل‌های .desktop از دایرکتوری مشخص‌شده.
نظارت بر تغییرات دایرکتوری و به‌روزرسانی خودکار محتوای جعبه‌آیکون.
استفاده از فیلد GenericName به جای Name برای برچسب میانبر.
استفاده از فیلد Name به جای نام فایل برای مرتب‌سازی موارد.
مرتب‌سازی موارد به صورت نزولی. اگر داده‌ها از stdin خوانده شوند، این گزینه بدون --sort-by-name بی‌اثر خواهد بود.
خواندن داده‌ها از stdin. داده‌ها باید به ترتیبِ Name، Tooltip، Icon، Command و InTerm باشند که با خط جدید جدا شده‌اند. InTerm یک ثابت بولی غیرحساس به بزرگ و کوچکی حروف (TRUE یا FALSE) است. ارسال نویسهٔ FormFeed محتوای جعبه‌آیکون را پاک می‌کند.
تنظیم عرض موارد.
اجبار به استفاده از اندازهٔ آیکون مشخص‌شده. این گزینه در حالت فشرده (compact) کار نمی‌کند.
استفاده از حالت فشرده. آیکون و نام هر مورد در یک ردیف تکی قرار می‌گیرد.
فعال‌سازی موارد با یک‌بار کلیک ماوس. این گزینه ممکن است در حالت فشرده به درستی کار نکند.
الگو برای ترمینال. به‌طور پیش‌فرض از `xterm -e %s' استفاده می‌شود که در آن %s با دستور جایگزین خواهد شد.

اگر هم دایرکتوری و هم stdin مشخص شده باشند، محتوای جعبه‌آیکون از دایرکتوری خوانده خواهد شد.

تنظیم نام فایل.
امکان انتخاب چند نام فایل در گفتگوی انتخاب فایل.
فعال‌سازی حالت انتخاب فقط دایرکتوری.
فعال‌سازی حالت ذخیره.
تعیین نویسهٔ جداکننده هنگام بازگرداندن چندین نام فایل.
تأیید انتخاب فایل در صورتی که نام فایل از قبل وجود داشته باشد. آرگومان اختیاری، متنی برای پنجرهٔ گفتگوی تأیید است.
مقدارهای خروجی به سبک شل درون علامت نقل‌قول قرار می‌گیرند.

تنظیم قلم اولیه. FONTNAME رشته‌ای با نمایش قلم در قالب "[FAMILY-LIST] [STYLE-OPTIONS] [SIZE]" است.
تنظیم متن پیش‌نمایش.
جداسازی خروجیِ توضیحات قلم انتخاب‌شده.
تنظیم نویسهٔ جداکنندهٔ خروجی. پیش‌فرض `|' است.
داده‌های خروجی در قالب نقل‌قول‌های شل خواهند بود..SS "گزینه‌های فرم (Form options)"
افزودن فیلد به فرم. نوع می‌تواند H، RO، NUM، CHK، CB، CBE، CE، FL، SFL، DIR، CDIR، FN، MFL، MDIR، DT، SCL، SW، APP، ICON، CLR، BTN، FBTN، LINK، LBL یا TXT باشد.
H - نوع فیلد پنهان. تمام نویسه‌ها به عنوان نویسه نامرئی نمایش داده می‌شوند.
RO - فیلد در حالت فقط‌خواندنی است.
NUM - فیلد عددی است. قالب مقدار اولیه برای این فیلد VALUE[!RANGE[!STEP![PREC]]] است، که در آن RANGE باید به صورت MIN..MAX باشد. `!' جداکننده پیش‌فرض موارد است. PREC دقت ارقام اعشاری است.
CHK - فیلد چک‌باکس (جعبه علامت‌زدن). مقدار اولیه یک مقدار ثابت بولی بدون حساسیت به حروف کوچک و بزرگ (TRUE یا FALSE) است.
CB - فیلد جعبه کشویی (combo-box). مقدار اولیه فهرستی به صورت VAL1!VAL2!... است. جداکننده همانند فیلد NUM است. مقداری که با `^' شروع شود، به عنوان مقدار پیش‌فرض جعبه کشویی در نظر گرفته می‌شود.
CBE - فیلد جعبه کشویی قابل ویرایش. مقدار اولیه همانند جعبه کشویی است.
CE - فیلد ورودی با تکمیل خودکار (completion). مقدار اولیه همانند جعبه کشویی است.
FL - دکمه انتخاب فایل.
SFL - فیلد برای ایجاد فایل.
DIR - دکمه انتخاب دایرکتوری.
CDIR - فیلد برای ایجاد پوشه.
FN - دکمه انتخاب قلم (فونت). مقدار اولیه همانند کادر محاوره‌ای قلم است.
MFL - انتخاب چندین فایل. مقدار این فیلد فهرستی از فایل‌ها است که با item-separator جدا شده‌اند.
MDIR - انتخاب چندین پوشه. مقدار این فیلد فهرستی از پوشه‌ها است که با item-separator جدا شده‌اند.
DT - فیلد تاریخ.
SCL - فیلد مقیاس (scale). مقدار این فیلد در محدوده 0..100 است.
SW - فیلد سوئیچ (کلید تبدیل). مقدار اولیه یک مقدار ثابت بولی بدون حساسیت به حروف کوچک و بزرگ (TRUE یا FALSE) است.
APP - دکمه انتخاب برنامه کاربردی. مقدار ورودی برای این فیلد mime-type است. مقدار خروجی - فایل اجرایی برنامه انتخاب‌شده.
ICON - فیلد آیکون. مانند فیلد ورودی معمول است اما دو آیکون دارد. آیکون سمت چپ، آیکون فعلی را نمایش می‌دهد و آیکون سمت راست قابل کلیک است و yad-con-browser را برای انتخاب آیکون فراخوانی می‌کند.
CLR - دکمه انتخاب رنگ. مقادیر خروجی برای این فیلد به همان شیوه کادر محاوره‌ای رنگ تولید می‌شوند.
BTN - فیلد دکمه. برچسب می‌تواند به شکل متنی با ساختار LABEL[!ICON[!TOOLTIP]] باشد که در آن `!' جداکننده موارد است. LABEL متن برچسب دکمه یا stock id مربوط به yad است. ICON آیکون دکمه است (stock id یا نام فایل). TOOLTIP متنی اختیاری برای رشته راهنمای بازشو (tooltip) است. مقدار اولیه، دستوری است که هنگام کلیک روی دکمه اجرا می‌شود. نمادهای ویژه %N در دستور با مقدار فیلد N جایگزین می‌شوند. اگر دستور با @ شروع شود، خروجی دستور پردازش شده و خطوطی که با عدد و دونقطه شروع می‌شوند به عنوان مقادیر جدید فیلدها در نظر گرفته خواهند شد. سبک نقل‌قول برای مقادیر هنگام استفاده از sh -c عبارت است از - نقل‌قول تکی در اطراف دستور و نقل‌قول دوتایی در اطراف آرگومان -c. دستور ویژه quit کادر محاوره‌ای را به روش معمول می‌بندد.
FBTN - مشابه فیلد دکمه، اما با برجستگی کامل (full relief) دکمه.
LINK - فیلد دکمه پیوند.
LBL - برچسب متنی. اگر نام فیلد خالی باشد، یک خط جداکننده افقی نمایش داده خواهد شد.
TXT - ورودی متنی چندخطی. این فیلد همیشه تمام عرض فرم را اشغال می‌کند.

بدون نوع، فیلد یک ورودی متنی ساده خواهد بود.

تنظیم تراز برچسب‌های فیلد. انواع ممکن عبارتند از left، center یا right. پیش‌فرض left است.
تنظیم تعداد ستون‌ها در فرم. فیلدها از بالا به پایین قرار خواهند گرفت.
تنظیم نویسه جداکننده خروجی. پیش‌فرض `|' است.
تنظیم فیلد دارای تمرکز (فوکوس).
خواندن چرخشی داده‌های stdin. ارسال نویسه FormFeed فرم را پاک می‌کند. این نماد می‌تواند با echo -e '\f' ارسال شود.
تراز کردن برچسب‌ها در فیلدهای دکمه با توجه به تنظیمات --align.
تنظیم نویسه جداکننده برای مقادیر جعبه کشویی یا مقیاس. پیش‌فرض `!' است.
تنظیم قالب برای فیلدهای تاریخ (مشابه کادر محاوره‌ای تقویم).
تنظیم دقت اعداد ممیز شناور. به صورت پیش‌فرض، دقت سه رقم بعد از ممیز است.
استفاده از نوع مشخص برای تکمیل خودکار پیشرفته. TYPE می‌تواند any برای مطابقت با هر یک از کلمات تایپ‌شده، all برای مطابقت با تمام کلمات تایپ‌شده یا regex باشد که در آن متن تایپ‌شده به عنوان یک عبارت منظم در نظر گرفته می‌شود.
پیمایش‌پذیر کردن فرم (قابلیت اسکرول).
یکسان کردن اندازه ارتفاع فیلدهای فرم و پهنای ستون‌ها.
اجرای CMD در هنگام تغییر مقدار فیلدهای CHK، CB یا SW. دستور با دو آرگومان اجرا می‌شود - شماره فیلد تغییریافته و مقدار فعلی آن. خروجی دستور به همان صورت فیلدهای BTN با پیشوند @ پردازش می‌شود. توجه - این گزینه ممکن است سرعت کادر محاوره‌ای شما را کاهش دهد.
مقادیر خروجی درون نقل‌قول‌هایی به سبک پوسته (shell-style quotes) خواهند بود.
خروجی دادن مقادیر فیلدها به صورت سطر به سطر در صورتی که چندین ستون مشخص شده باشد.
خروجی دادن اندیس عنصر فعال به جای متن برای فیلدهای جعبه کشویی (combo-box).

داده‌های اضافی در خط فرمان به عنوان مقادیر پیش‌فرض برای فیلدهای فرم تفسیر می‌شوند. مقدار ویژه @disabled@ فیلد متناظر را غیرفعال می‌کند. اگر هیچ آرگومان اضافی در خط فرمان مشخص نشده باشد، داده‌ها از stdin، یک مقدار در هر خط خوانده می‌شوند. خواندن چرخشی به این معناست که برای N فیلد، مقدار N+1 جایگزین فیلد اول خواهد شد. مقادیر خالی هنگام خواندن از stdin نادیده گرفته می‌شوند..SS گزینه‌های HTML (HTML options)

مکان مشخص‌شده را باز می‌کند. URI می‌تواند نام یک فایل یا یک نشانی اینترنتی باشد. اگر URI یک فایل موجود نباشد و پروتکل مشخص نشده باشد، پیشوند http:// به URI افزوده خواهد شد.
حالت مرورگر را فعال می‌کند. در این حالت، تمام پیوندهای کلیک‌شده در ویجت html باز می‌شوند و دستور Open به منوی زمینه‌ای اضافه خواهد شد.
پیوندهای کلیک‌شده را در خروجی استاندارد چاپ می‌کند. به‌طور پیش‌فرض، پیوندهای کلیک‌شده با xdg-open باز می‌شوند.
نوع mime داده‌های ارسال‌شده به ورودی استاندارد را روی MIME تنظیم می‌کند. پیش‌فرض text/html است.
کدگذاری داده‌های ارسال‌شده به ورودی استاندارد را روی ENCODING تنظیم می‌کند. پیش‌فرض UTF-8 است.
گرداننده خارجی برای uri کلیک‌شده تعیین می‌کند. %s با uri فعال‌شده جایگزین خواهد شد. کد بازگشتی CMD برای ادامه کار باید 0، برای نادیده گرفتن uri برابر با 1 و برای بارگیری uri برابر با 2 باشد. این گزینه فقط در حالت مرورگر کار می‌کند. دو متغیر محیطی در گرداننده در دسترس است - YAD_HTML_BUTTON با مقدار کلید ماوس فشرده‌شده و YAD_HTML_STATE با مقدار ماسک بیتیِ وضعیت کلیدهای تبدیل (modifier keys).
رشته عامل کاربر (user agent) را تنظیم می‌کند. پیش‌فرض YAD-Webkit (@VERSION@) است.
شیوه‌نامه‌های سفارشی کاربر را از فایل یا داده‌های دلخواه بارگیری می‌کند. STRING می‌تواند مسیری به یک فایل محلی حاوی کد CSS یا خود کد CSS باشد.
نوار جستجو را غیرفعال می‌کند.
عملیات فایل را فعال می‌کند. این گزینه آیتم open را به منوی بازشو اضافه می‌کند.
تنظیمات اضافی WebKit را اعمال می‌کند. این گزینه می‌تواند چندین بار استفاده شود. تنظیم PROP باید در قالب "setting-name value" باشد. اولین نویسه از مقدار باید شناسه نوع باشد: b برای مقادیر بولی، i برای اعداد صحیح و s برای رشته‌ها. پس از آن خود مقادیر به دنبال یک دو‌نقطه می‌آیند. فهرستی از تنظیمات ممکن در این صفحه قابل مشاهده است - https://webkitgtk.org/reference/webkit2gtk/stable/WebKitSettings.html

هنگامی که کادر محاوره‌ای در حالت مرورگر کار می‌کند، داده‌های اضافی در خط فرمان به‌عنوان URI تفسیر می‌شوند.

سربرگ ستون را تعیین می‌کند. انواع عبارتند از: TEXT، NUM، SZ، FLT، CHK، RD، BAR، IMG، HD یا TIP. نوع TEXT پیش‌فرض است. از NUM برای اعداد صحیح و از FLT برای مقادیر اعشاری مضاعف استفاده کنید. TIP برای تعریف ستون راهنمای ابزار (tooltip) به‌کار می‌رود. نوع ستون اندازه SZ دقیقاً مانند ستون NUM عمل می‌کند اما به جای اعداد، اندازه‌ها را با فرمت خوانا برای انسان نمایش می‌دهد. ستون‌های CHK (جعبه‌های علامت‌زدن) و RD (دکمه رادیویی) ستون‌های بولی هستند. BAR یک ستون نوار پیشرفت است. مقدار باید بین 0 و 100 باشد. اگر مقدار خارج از این بازه باشد، به نزدیک‌ترین مقدار مجاز برش می‌خورد. نوع HD نشان‌دهنده یک ستون پنهان است. چنین ستون‌هایی در فهرست نمایش داده نمی‌شوند، بلکه فقط در خروجی ظاهر می‌شوند. IMG می‌تواند مسیری به یک تصویر یا نام نماد از تم نماد فعلی GTK+ باشد. اندازه نمادها می‌تواند در فایل پیکربندی gtk در موقعیت GTK_ICON_SIZE_MENU از gtk-icon-sizes تنظیم شود. تصاویری که با نام نماد مشخص شده‌اند به GTK_ICON_SIZE_MENU مقیاس‌بندی می‌شوند، مگر اینکه گزینه --force-icon-size تنظیم شده باشد. فیلد تصویر به عنوان یک مقدار خالی چاپ می‌شود.

نام‌های ستون ویژه @fore@، @back@ و @font@ ویژگی‌های سطرهای مربوطه را تنظیم می‌کنند. مقادیر این ستون‌ها در نتایج نمایش داده نمی‌شوند.

عنوان ستون می‌تواند در قالب name!tooltip مشخص شود و از نشانه‌گذاری پنگو (Pango markup) می‌توان در بخش‌های name و tooltip استفاده کرد.

حالت درختی را فعال می‌کند. در این حالت داده‌های اضافی به شکل ROW_ID[:PARENT_ID] باید قبل از هر سطر به yad ارسال شود. برای جزئیات بخش مثال‌ها (EXAMPLES) را ببینید.
از جعبه‌های علامت‌زدن برای ستون اول استفاده می‌کند. سطرهای تیک‌خورده را به جای سطرهای انتخاب‌شده خروجی می‌دهد. انتخاب چندگانه را غیرفعال می‌کند.
مشابه --checklist است اما با یک دکمه رادیویی برای ستون اول.
نویسه‌های جداکننده خروجی را تنظیم می‌کند.
امکان انتخاب همزمان چندین سطر را فراهم می‌کند.
امکان تغییر متن را فراهم می‌کند.
فهرست ستون‌های قابل ویرایش را تنظیم می‌کند. LIST باید رشته‌ای از اعداد باشد که با کاما از هم جدا شده‌اند.
سربرگ‌های ستون را نشان نمی‌دهد.
مرتب‌سازی محتوای ستون با کلیک روی سربرگ آن را غیرفعال می‌کند.
سطرهای زوج و فرد را با رنگ‌های متفاوت رسم نمی‌کند. این گزینه به تم gtk فعلی شما بستگی دارد و ممکن است عمل نکند.
خطوط شبکه از نوع TYPE را در کادر محاوره‌ای فهرست رسم می‌کند. TYPE می‌تواند یکی از موارد hor[izontal]، vert[ical] یا both باشد.
قابلیت انتخاب را در فهرست غیرفعال می‌کند.
تمام داده‌های فهرست را چاپ می‌کند.
مشخص می‌کند کدام ستون در خروجی استاندارد چاپ شود. 0 می‌تواند برای چاپ تمام ستون‌ها استفاده شود (این حالت پیش‌فرض است).
ستون مشخص‌شده را پنهان می‌کند.
--expand-column=NUMBER
ستون را به‌طور پیش‌فرض گسترش‌پذیر می‌کند. 0 همه ستون‌ها را گسترش‌پذیر تنظیم می‌کند.
ستون جستجوی سریع را تعیین می‌کند. 0 به معنای غیرفعال کردن جستجو است. به‌طور پیش‌فرض جستجو روی ستون اول انجام می‌شود.
--tooltip-column=NUMBER
ستون حاوی راهنمای ابزار بازشو را مشخص می‌کند.
ستون جداکننده سطر را مشخص می‌کند. اگر مقدار خانه از این ستون برابر با مقدار جداکننده سطر مشخص‌شده باشد، چنین سطری به عنوان جداکننده رسم خواهد شد. مقدار جداکننده سطر باید تعیین شده باشد.
مقدار TEXT را به عنوان مقدار جداکننده سطر تعیین می‌کند. این قابلیت وابستگی زیادی به تم GTK+ فعلی شما دارد و ممکن است به درستی کار نکند.
تعداد سطرهای کادر محاوره‌ای فهرست را تعیین می‌کند. تنها آخرین NUMBER سطر نمایش داده خواهند شد. این گزینه تنها زمانی اعمال می‌شود که داده‌ها از stdin خوانده شوند.
پهنای ستون پیش از پیچش خطوط را روی NUMBER تنظیم می‌کند.
فهرست ستون‌های دارای پیچش خط را تنظیم می‌کند. LIST باید رشته‌ای از اعداد جداشده با کاما باشد.
حالت کوتاه‌سازی متن با سه‌نقطه (ellipsize) را برای ستون‌های متنی تعیین می‌کند. TYPE می‌تواند NONE، START، MIDDLE یا END باشد.
فهرست ستون‌های دارای کوتاه‌سازی را تنظیم می‌کند. LIST باید رشته‌ای از اعداد جداشده با کاما باشد.
دستور CMD را به عنوان دستور دوبار کلیک تعیین می‌کند. وقتی کاربر روی سطری دوبار کلیک کند، CMD با مقادیر همه ستون‌ها به عنوان آرگومان اجرا خواهد شد. به‌طور پیش‌فرض، دوبار کلیک سطر را انتخاب کرده و برای فهرست‌های ساده مانند دکمه OK عمل می‌کند، اگر --checklist مشخص شده باشد جعبه علامت را تیک می‌زند و هنگامی که فهرست با گزینه --multiple اجرا شده باشد کاری انجام نمی‌دهد. وقتی دوبار کلیک تعیین شده باشد، کلید Enter به عنوان دوبار کلیک و کلید ترکیبی Ctrl+Enter به عنوان دکمه OK عمل می‌کند. CMD می‌تواند شامل نویسه ویژه '%s' برای تعیین جایگاه آرگومان‌ها باشد. به‌طور پیش‌فرض آرگومان‌ها به انتهای CMD الحاق خواهند شد. اگر CMD با @ شروع شود، خروجی آن جایگزین مقادیر سطر فعلی خواهد شد. این گزینه با --editable کار نمی‌کند.
دستور CMD را به عنوان عملیاتی که هنگام تغییر انتخاب رخ می‌دهد تعیین می‌کند. CMD با مقادیر همه ستون‌ها به عنوان آرگومان اجرا خواهد شد. CMD می‌تواند شامل نویسه ویژه '%s' برای تعیین جایگاه آرگومان‌ها باشد. به‌طور پیش‌فرض آرگومان‌ها به انتهای CMD الحاق خواهند شد. این گزینه با --multiple کار نمی‌کند.
دستور CMD را به عنوان عملیاتی که هنگام افزودن، ویرایش یا حذف سطر اجرا می‌شود تعیین می‌کند. نخستین آرگومان دستور، نام عملیات است (add، edit یا del). بقیه خط فرمان داده‌های سطر انتخاب‌شده هستند. خروجی این دستور مقادیر سطر جدید را تعیین می‌کند.
تمام گره‌های درخت را در هنگام راه‌اندازی باز (گسترده) می‌کند.
از عبارت‌های منظم در جستجو برای فیلدهای متنی استفاده می‌کند.
به داده‌ها از ورودی استاندارد (stdin) گوش می‌دهد، حتی اگر مقادیر خط فرمان مشخص شده باشند.
مقادیر خروجی به سبک شل داخل علامت نقل‌قول قرار می‌گیرند.
دقت اعداد ممیز شناور را تعیین می‌کند. به‌طور پیش‌فرض دقت سه رقم اعشار پس از ممیز است.
رکوردهای جدید را در بالای فهرست اضافه می‌کند.
پیمایش خودکار به انتهای فهرست هنگام اضافه شدن یک سطر جدید.
از واحدهای استاندارد IEC (بر پایه ۱۰۲۴) برای مقادیر اندازه استفاده می‌کند. با این گزینه مقادیر دارای پسوندهای KiB، MiB و GiB خواهند بود.
از نشانه‌گذاری در راهنمای ابزار استفاده نمی‌کند، حتی اگر متن دارای نشانه‌گذاری معتبر باشد.
از نام سربرگ به عنوان متن پشتیبان راهنمای ابزار استفاده می‌کند.
تراز محتوای ستون‌ها را تنظیم می‌کند. STRING باید شامل آرایه‌ای از حروف l، r یا c برای تراز چپ، راست یا وسط باشد.
تراز سربرگ‌های ستون را تنظیم می‌کند. STRING مشابه با --column-align است..PP ارسال نویسهٔ FormFeed به فهرست، آن را پاک می‌کند. این نماد می‌تواند با echo -e '\f' ارسال شود.

تنظیم کلید فرزندان.
افزودن زبانه با برچسب مشخص‌شده به notebook. مقدار TEXT می‌تواند در قالب LABEL[!ICON[!TOOLTIP]] باشد که در آن «!» جداکنندهٔ موارد است. برای حالت stack، مقدار TEXT برای برچسب همان‌گونه که هست استفاده می‌شود.
تنظیم موقعیت زبانه‌ها. مقدار می‌تواند top، bottom، left یا right باشد. پیش‌فرض top است. برای حالت stack فقط موقعیت‌های top یا bottom در دسترس هستند.
تنظیم پهنای کادر دور ویجت در زبانه‌ها.
تنظیم زبانهٔ فعال.
گسترش دادن همهٔ زبانه‌ها به تمام پهنای پنجرهٔ گفتگو.
استفاده از حالت پشته (GtkStack به‌جای GtkNotebook).

برای اطلاعات بیشتر دربارهٔ گفتگوی notebook، بخش NOTEBOOK and PANED را ببینید.

تنظیم دستوری که هنگام کلیک روی آیکون اجرا می‌شود. اگر --listen مشخص نشده باشد، کنش پیش‌فرض quit است.
گوش دادن به دستورها در stdin. بخش NOTIFICATION را ببینید.
تنظیم منوی اولیه برای راست‌کلیک.
تنظیم نویسهٔ جداکننده برای مقادیر منو. پیش‌فرض | است.
تنظیم نویسهٔ جداکننده برای موارد منو. پیش‌فرض ! است.
غیرفعال‌سازی خروج با کلیک وسط.
عدم نمایش آیکون هنگام راه‌اندازی.
تنظیم اندازهٔ آیکون اعلان به SIZE. این گزینه برای آیکون‌های تم‌دار کار نمی‌کند.

برای اطلاعات بیشتر دربارهٔ جداکننده‌ها، بخش NOTIFICATION را ببینید.

گوش دادن به دستورها در stdin. بخش NOTIFICATION را ببینید.
تنظیم منوی اولیه برای راست‌کلیک.
تنظیم نویسهٔ جداکننده برای مقادیر منو. پیش‌فرض | است.
تنظیم نویسهٔ جداکننده برای موارد منو. پیش‌فرض ! است.
عدم نمایش آیکون هنگام راه‌اندازی.

تنظیم کلید فرزندان.
تنظیم جهت‌گیری قاب‌ها درون پنجرهٔ گفتگو. مقدار TYPE می‌تواند hor[izontal] یا vert[ical] باشد.
تنظیم موقعیت اولیهٔ جداکننده.
تنظیم قاب برای تمرکز (focus) اولیه. مقدار PANE باید ۱ یا ۲ باشد. پیش‌فرض ۱ است.

برای اطلاعات بیشتر دربارهٔ گفتگوی paned، بخش NOTEBOOK and PANED را ببینید..SS "گزینه‌های تصویر (Picture options)"

اندازه اولیه تصویر را تعیین می‌کند. مقادیر موجود عبارتند از fit برای جا دادن تصویر در پنجره یا orig برای نمایش تصویر در اندازه اصلی.
مقدار گام افزایش برای مقیاس‌بندی تصویر را تنظیم می‌کند.
نام فایل تصویر را تنظیم می‌کند. اگر نام فایلی مشخص نشود، داده‌های اضافی (extra data) به کار گرفته خواهند شد. در این حالت می‌توان چندین نام فایل را مشخص کرد.
عملیات فایل را فعال می‌کند. این گزینه مورد منوی باز کردن را به منوی بازشو اضافه می‌کند.
دستوری را مشخص می‌کند که پس از تغییر تصویر اجرا می‌شود. آرگومان دستور، نام فایل تصویر فعلی است. آرگومان می‌تواند با الگوی «%s» مشخص شود، وگرنه آخرین بخش دستور خواهد بود.

برخی از عملیات روی تصویر مانند ناوبری، مقیاس‌بندی یا چرخش، از طریق منوی بازشو (popup menu) در دسترس هستند. این اقدامات را تنها می‌توان روی تصاویر ایستا (static images) انجام داد.

پنجره بازشو را شفاف می‌کند.
زمان پایان پیش‌فرض (timeout) را تغییر می‌دهد. به طور پیش‌فرض زمان پایان ۳۰۰ ثانیه است.
پنجره بازشو را به طور خودکار نمی‌بندد. به طور پیش‌فرض پنجره پس از TIMEOUT ثانیه بسته خواهد شد.
تراز عنوان و متن پنجره بازشو را مشخص می‌کند. TYPE می‌تواند یکی از مقادیر left، center یا right باشد.

نوع فایل مبدا را تنظیم می‌کند. TYPE می‌تواند TEXT برای فایل‌های متنی، IMAGE برای فایل‌های تصویری یا RAW برای فایل‌هایی در قالب postscript یا pdf باشد.
نام یا مسیر فایل مبدا را تنظیم می‌کند.
سرصفحه‌هایی شامل نام فایل و شماره صفحه را به بالای صفحه اضافه می‌کند. این گزینه برای نوع RAW کار نمی‌کند.
دکمه Preview را به گفتگوی چاپ اضافه می‌کند. این گزینه برای نوع RAW کار نمی‌کند.
قلم را برای چاپ متن تنظیم می‌کند. FONTNAME رشته‌ای با ساختار نمایشی قلم به شکل "[FAMILY-LIST] [STYLE-OPTIONS] [SIZE]" است. این گزینه فقط برای نوع TEXT کار می‌کند.

هنگامی که گزینه --progress استفاده می‌شود، yad خطوط داده‌های پیشرفت را از stdin می‌خواند. زمانی که خطوط با # آغاز شوند، متن پس از # در برچسب نوار پیشرفت نمایش داده می‌شود. مقادیر عددی به عنوان درصد برای نوار پیشرفت در نظر گرفته می‌شوند.

یک نوار پیشرفت اضافه می‌کند. LABEL برچسب متنی برای نوار پیشرفت است. TYPE نوع نوار پیشرفت می‌باشد. انواع آن عبارتند از: NORM برای نوار پیشرفت عادی، RTL برای نوار پیشرفت معکوس، PULSE برای نوار پیشرفت ضربانی و CPULSE برای نوار پیشرفت ضربانی پیوسته. اگر هیچ نواری مشخص نشود، گفتگوی پیشرفت در حالت single-bar کار خواهد کرد.
جهت‌گیری نوارهای پیشرفت را عمودی قرار می‌دهد.
تراز برچسب‌های نوار را تنظیم می‌کند. انواع ممکن left، center یا right هستند. پیش‌فرض left است.
برچسب نوار پیشرفت را به TEXT تغییر می‌دهد. این گزینه تنها در حالت single-bar کار می‌کند.
متن را در نوارهای پیشرفت پنهان می‌کند.
جهت نوار پیشرفت را از راست به چپ تنظیم می‌کند. این گزینه تنها در حالت single-bar کار می‌کند.
هنگامی که پیشرفت به ۱۰۰٪ رسید، گفتگو را می‌بندد.
اگر دکمه لغو فشرده شود، فرایند والد را متوقف می‌کند (kill).
نوار پیشرفت را ضربانی می‌کند. این گزینه تنها در حالت single-bar کار می‌کند.
نوار پیشرفت را با ضربان پیوسته فعال می‌کند. این گزینه تنها در حالت single-bar کار می‌کند.
چیدمان را قابل پیمایش می‌کند.
پنجره گزارش (log) را نمایش می‌دهد. این پنجره به جای تنظیم متن پیشرفت مربوطه، تمام خطوط ورودی از stdin را که با # شروع شده‌اند جمع‌آوری می‌کند. آرگومان اختیاری TEXT یک برچسب متنی برای بخش بازشونده (expander) پنجره است.
پنجره لاگ را در بالای نوارهای پیشرفت قرار می‌دهد.
پنجره لاگ را از ابتدا به صورت بازشده نمایش می‌دهد.
ارتفاع پنجره لاگ را تنظیم می‌کند.

مقادیر اولیه برای نوارها به صورت آرگومان‌های اضافی تعیین می‌شوند. هر خط حاوی داده‌های پیشرفت که به stdin فرستاده می‌شود، باید با N: آغاز شود که در آن N شماره نوار پیشرفت است. در حالت single-bar نیازی به N: نیست..SS "گزینه‌های اطلاعات متنی (Text info options)"

باز کردن فایل مشخص‌شده.
امکان تغییر و ویرایش متن.
فعال‌سازی شکست خودکار خطوط متن.
فعال‌سازی نشانه‌گذاری Pango. این گزینه همراه با گزینهٔ --editable کار نمی‌کند.
تنظیم تراز متن. مقدار TYPE می‌تواند left (چپ)، right (راست)، center (وسط) یا fill (تراز کامل) باشد. پیش‌فرض left است.
تنظیم حاشیه‌های متن روی NUMBER.
پیمایش خودکار به انتها هنگام نمایش متن جدید. این گزینه فقط زمانی کار می‌کند که متن از stdin خوانده شود.
پرش به خط مشخص‌شده در هنگام راه‌اندازی. این گزینه فقط زمانی کار می‌کند که نام فایل مشخص شده باشد.
نمایش مکان‌نما در حالت فقط‌خواندنی.
پیوندهای موجود در متن را قابل کلیک می‌کند. پیوندها با دستور xdg-open باز می‌شوند.
تنظیم رنگ پیش‌فرض متن.
تنظیم رنگ پیش‌فرض پس‌زمینه.
تنظیم رنگ پیوندها. پیش‌فرض blue است.
شنود داده‌ها از stdin، حتی در صورتی که نام فایل مشخص شده باشد.
ذخیرهٔ فایل در هنگام خروج به جای چاپ محتوای آن در stdout. این گزینه فقط در صورتی کار می‌کند که فایل از خط فرمان مشخص شده باشد.
فعال‌سازی عملیات فایل. این گزینه موارد باز کردن و ذخیره را به منوی بالاپر (popup) اضافه می‌کند. این گزینه فقط در حالت قابل ویرایش کار می‌کند.
غیرفعال کردن نوار جستجو.
درخواست تأیید برای ذخیرهٔ فایل در صورتی که محتوای آن تغییر کرده باشد. این گزینه فقط زمانی کار می‌کند که --in-place مشخص شده باشد. آرگومان اختیاری، متنی برای کادر گفتگوی تأیید است.
گزینه‌های بعدی فقط در صورتی کار می‌کنند که yad همراه با GtkSourceView کامپایل شده باشد.
برجسته‌سازی نحو برای LANGUAGE مشخص‌شده.
تنظیم پوستهٔ مورد استفاده روی THEME. برای دریافت فهرست تمام پوسته‌های در دسترس از yad-tools(1) استفاده کنید.
مشخص کردن نوع MIME داده‌های ورودی. این گزینه فقط برای حدس زدن برجسته‌سازی نحو مناسب مورد نیاز است.
نمایش شمارهٔ خطوط.
برجسته کردن خط کنونی.
فعال‌سازی حالت نشانه‌گذاری خطوط. دو نوع نشانه وجود دارد؛ نوع اول با کلیک دکمهٔ چپ ماوس و نوع دوم با کلیک دکمهٔ راست ماوس تنظیم می‌شود.
تنظیم رنگ پس‌زمینه برای نشانه‌های نوع اول روی COLOR. پیش‌فرض lightgreen است.
تنظیم رنگ پس‌زمینه برای نشانه‌های نوع دوم روی COLOR. پیش‌فرض pink است.
فعال‌سازی نشانگر حاشیهٔ راست. آرگومان اختیاری POS موقعیت حاشیه بر حسب تعداد نویسه‌ها است. پیش‌فرض 80 است.
برجسته کردن قلاب‌ها و پرانتزهای متناظر.
فعال کردن تورفتگی خودکار. این گزینه همچنین کلید TAB را به عنوان کلید تورفتگی تعیین می‌کند.
تنظیم رفتار کلیدهای HOME و END. مقدار TYPE یکی از مقادیر newer، before، after یا always است.
فعال کردن حالت هوشمند برای BackSpace. در صورت فعال بودن این گزینه، کلید BackSpace فاصله‌ها را تا موقعیت پرش‌گر (tab) بعدی پاک می‌کند.
تنظیم گام پرش‌بندی (tabulation).
تنظیم گام تورفتگی.
درج فاصله به جای تب.

اگر گزینهٔ fontname برای گفتگوی متنی مشخص شده باشد، توصیف قلم باید به سبک CSS باشد (نه به سبک Pango). ارسال نویسهٔ FormFeed به گفتگوی متنی موجب پاک شدن آن می‌شود. این نماد می‌تواند به صورت echo -e '\f' ارسال شود. فشردن Ctrl+S ورودی جستجو را در گفتگوی متنی به صورت بازشو نمایش می‌دهد..SS گزینه‌های مقیاس (Scale options)

تنظیم مقدار اولیه.
تنظیم کمینه مقدار.
تنظیم بیشینه مقدار.
تنظیم اندازه گام.
تنها اجازه دادن به مقادیری که در مضارب گام هستند.
تنظیم اندازه پرش (صفحه‌بندی). به طور پیش‌فرض مقدار پرش برابر با STEP*10 است.
--print-partial
چاپ مقادیر جزئی و میانی.
پنهان کردن مقدار.
نمایش مقیاس عمودی.
معکوس کردن جهت مقیاس.
نمایش دکمه‌ها در لبه‌های مقیاس برای افزایش یا کاهش مقدار مقیاس.
افزودن یک نشانه به مقیاس. می‌تواند چندین بار استفاده شود. NAME آرگومانی اختیاری برای برچسب‌گذاری نشانه است.

افزودن یک فیلتر نام فایل. NAME نام نمایشی فیلتر است و PATTERN یک الگوی نام فایل به سبک پوسته است (برای مثال *.txt). این گزینه می‌تواند چندین بار استفاده شود.
افزودن یک فیلتر نوع mime. NAME نام نمایشی فیلتر است و PATTERN نام یک نوع mime است (برای مثال text/plain). این گزینه می‌تواند چندین بار استفاده شود.
افزودن فیلتر برای تصاویری که توسط کتابخانه gdk-pixbuf پشتیبانی می‌شوند. NAME نام اختیاری این فیلتر است.
این گزینه‌ها برای تمام کادرهای گفتگوی انتخاب فایل yad اعمال می‌شوند.

افزودن ویجت پیش‌نمایش. تصاویر پیش‌نمایش مطابق با مشخصات بندانگشتی‌های XDG نگارش 0.8.0 (http://standards.freedesktop.org/thumbnail-spec/latest) از بندانگشتی‌های عادی (پیش‌فرض) یا بزرگ بارگیری می‌شوند، یا توسط yad برای فایل‌های تصویری ساخته شده و به عنوان بندانگشتی‌های عادی یا بزرگ ذخیره می‌شوند.
استفاده از پیش‌نمایش‌های بزرگ به صورت پیش‌فرض. این گزینه می‌تواند از طریق تنظیمات yad به صورت دائمی فعال شود.
این گزینه‌ها برای تمام کادرهای گفتگوی انتخاب فایل yad اعمال می‌شوند.
نکته: برنامه YAD مقدار mtime را برای تصاویر بندانگشتی بررسی نمی‌کند و اگر فایل اصلی پس از ایجاد تصویر بندانگشتی تغییر کند، پیش‌نمایش را به‌روزرسانی نخواهد کرد.

-?, --help
نمایش خلاصه گزینه‌ها.
نمایش کادر گفتگوی درباره نرم‌افزار.
نمایش نسخه برنامه.

همچنین گزینه‌های استاندارد GTK+ نیز پذیرفته می‌شوند..SH "دفترچه و قاب‌بندی (NOTEBOOK and PANED)" دفترچه (Notebook) یک کادر گفتگوی مرکب است که کادرهای گفتگوی دیگر را در زبانه‌های خود جای می‌دهد. کادرهای گفتگو با یک کلید یکتا (عدد صحیح) شناسایی می‌شوند و باید در یک حالت اتصالی ویژه (گزینهٔ --plug) اجرا شوند. مثال زیر یک کادر گفتگوی دفترچه را با دو زبانه اجرا می‌کند؛ زبانهٔ نخست دارای یک متن ساده است و زبانهٔ دوم یک کادر ورودی است.

#! /bin/sh

yad --plug=12345 --tabnum=1 --text="first tab with text" &> res1 &
yad --plug=12345 --tabnum=2 --text="second tab" --entry &> res2 &
yad --notebook --key=12345 --tab="Tab 1" --tab="Tab 2"

نکته: ترتیب نتایج خروجی برای زبانه‌ها نامشخص است!

قاب‌بندی (Paned) به همان شیوهٔ دفترچه عمل می‌کند با یک محدودیت - تنها اولین و دومین کادر گفتگوی متصل‌شده درون قاب‌ها جای می‌گیرند.

امکان ارسال دستورها را به yad در قالب command:args فراهم می‌کند. دستورهای ممکن عبارتند از icon، tooltip، visible، action، menu و quit.

تنظیم آیکون اعلان به ICONNAME.
تنظیم متن راهنمای (tooltip) اعلان.
تنظیم وضعیت آیکون اعلان به حالت مرئی یا نامرئی.
تعیین دستوری که هنگام کلیک روی آیکون اجرا می‌شود. دو دستور ویژه وجود دارد - menu برای نمایش منوی بازشوی تعریف‌شده توسط کاربر و quit برای خروج از برنامه.
تنظیم منوی بازشو برای آیکون اعلان. ‏STRING باید در قالب name1[!action1[!icon1]]|name2[!action2[!icon2]]... باشد. نام خالی یک جداکننده به منو اضافه می‌کند. نویسهٔ جداکننده برای مقادیر (مثلاً `|') با آرگومان --separator تعیین می‌شود. نویسهٔ جداکننده برای موارد منو (مثلاً `!') با آرگومان --item-separator تعیین می‌شود.
خروج از برنامه. کلیک میانی روی آیکون نیز دستور quit را ارسال می‌کند.

این فهرستی از موارد از پیش تعریف‌شدهٔ موجود در yad است.
شناسه متن برچسب نام آیکون
yad-about درباره help-about
yad-add افزودن list-add
yad-apply اعمال gtk-apply
yad-cancel انصراف gtk-cancel
yad-clear پاک‌سازی document-clear
yad-close بستن window-close
yad-edit ویرایش gtk-edit
yad-execute اجرا system-run
yad-no خیر gtk-no
yad-ok تأیید gtk-ok
yad-open باز کردن document-open
yad-print چاپ document-print
yad-quit خروج application-exit
yad-refresh تازه‌سازی view-refresh
yad-remove حذف list-remove
yad-save ذخیره document-save
yad-search جستجو system-search
yad-send ارسال document-send
yad-settings تنظیمات gtk-preferences
yad-yes بله gtk-yes

این متغیر می‌تواند برخی گزینه‌های پیش‌فرض را برای yad نگه دارد. تمام گزینه‌های موجود در این متغیر را می‌توان از خط فرمان بازتعریف کرد.
محل فایل حاوی تنظیمات yad. برای جزئیات به بخش SETTINGS مراجعه کنید.
این متغیر با مقدار pid کادر گفتگوی فعلی مقداردهی می‌شود و در تمام فرزندان کادر گفتگو در دسترس است.
این متغیر با مقدار شناسهٔ پنجرهٔ اکس (X Window ID) کادر گفتگوی فعلی مقداردهی می‌شود و در تمام فرزندان کادر گفتگو در دسترس است. این متغیر در کادرهای گفتگوی چاپ و اعلان، و همچنین در کادرهایی که به عنوان فرزند دفترچه یا قاب عمل می‌کنند، مقداردهی نمی‌شود..SH "سیگنال‌های تعریف‌شده توسط کاربر (USER DEFINED SIGNALS)"
بستن کادر محاوره با کد خروج 0.
بستن کادر محاوره با کد خروج 1.

0
کاربر دکمه‌ی OK را فشرده است
1
کاربر دکمه‌ی Cancel را فشرده است
70
کادر محاوره به دلیل پایان مهلت زمانی بسته شده است.
252
کادر محاوره با فشردن Esc یا با استفاده از عملکردهای پنجره برای بستن کادر محاوره بسته شده است
کدهای خروج برای دکمه‌های مشخص‌شده توسط کاربر باید در خط فرمان تعیین شوند. کد خروج زوج به معنای چاپ نتیجه است؛ کد فرد فقط کد خروج را بازمی‌گرداند.

ظاهر و رفتار کادرهای محاوره‌ی yad می‌تواند از طریق فایل gtkrc سفارشی‌سازی شود. در ادامه نام ابزارک‌های yad آمده است:
نام ابزارک نوع ابزارک توضیحات
yad-dialog-window GtkDialog پنجره کادر محاوره
yad-dialog-image GtkImage تصویر کادر محاوره
yad-dialog-label GtkLabel متن کادر محاوره
yad-app-widget GtkAppChooserWidget ابزارک انتخاب برنامه
yad-calendar-widget GtkCalendar ابزارک تقویم
yad-color-widget GtkColorChooser ابزارک انتخاب رنگ
yad-color-palette GtkTreeView فهرست رنگ‌های از پیش‌تعریف‌شده
yad-entry-label GtkLabel برچسب ورودی
yad-entry-widget GtkEntry ابزارک ورودی
yad-entry-spin GtkSpinButton ابزارک ورودی برای مقادیر عددی
yad-entry-combo GtkComboBox ابزارک ورودی با کمبو
yad-entry-edit-combo GtkComboBoxEntry ابزارک ورودی با کمبوی قابل ویرایش
yad-file-widget GtkFileChooser ابزارک انتخاب فایل
yad-font-widget GtkFontChooser ابزارک انتخاب قلم
yad-form-flabel GtkLabel برچسب فیلد در فرم
yad-form-button GtkButton فیلد دکمه در فرم
yad-form-entry GtkEntrfy فیلد ورودی در فرم
yad-form-spin GtkSpinButton فیلد ورودی عددی در فرم
yad-form-check GtkCheckButton فیلد چک‌باکس در فرم
yad-form-combo GtkComboBox فیلد کمبو در فرم
yad-form-edit-combo GtkComboBoxEntry فیلد کمبوی قابل ویرایش در فرم
yad-form-link GtkLinkButton فیلد پیوند در فرم
yad-form-file GtkFileChooserButton فیلد فایل یا دایرکتوری در فرم
yad-form-font GtkFontChooserButton فیلد قلم در فرم
yad-form-app GtkAppChooserButton فیلد برنامه در فرم
yad-form-switch GtkSwitch فیلد کلید در فرم
yad-form-color GtkColorChooserButton فیلد رنگ در فرم
yad-form-label GtkLabel فیلد برچسب در فرم
yad-form-scale GtkScale ابزارک مقیاس در فرم
yad-form-separator GtkSeparator جداکننده در فرم
yad-form-text GtkTextView فیلد متنی چندخطی در فرم
yad-icons-full GtkIconView ابزارک آیکون‌ها برای حالت عادی
yad-icons-compact GtkTreeView ابزارک آیکون‌ها برای حالت فشرده
yad-list-widget GtkTreeView ابزارک فهرست
yad-notebook-widget GtkNotebook ابزارک دفترچه
yad-paned-widget GtkPaned ابزارک قاب افقی یا عمودی
yad-progress-widget GtkProgressBar ابزارک نوار پیشرفت
yad-scale-widget GtkScale ابزارک مقیاس
yad-stack-widget GtkStack ابزارک پشته
yad-stack-switcher-widget GtkStackSwitcher ابزارک تعویض‌کننده پشته
yad-text-widget GtkTextView ابزارک اطلاعات متنی
yad-timeout-indicator GtkProgreeBar نشانگر مهلت زمانی

برنامه YAD برخی از مقادیر پیش‌فرض را از فایل تنظیمات می‌خواند. این فایل می‌تواند با آرگومان --write-settings ایجاد شود. نحو این فایل یک سبک ساده ini است. مکان پیش‌فرض $XDG_CONFIG_HOME/yad/settings.conf است و می‌تواند با متغیر محیطی YAD_SETTINGS_FILE بازتعریف شود..SH "مثال‌ها (EXAMPLES)" نمایش یک انتخاب‌گر فایل با عنوان Select a file to remove. فایل انتخاب‌شده در خروجی استاندارد بازگردانده می‌شود.

yad --title="Select a file to remove"; --file-selection

نمایش یک کادر گفتگوی ورود متن با عنوان Select Host و متن Select the host you would like to flood-ping. متن واردشده در خروجی استاندارد بازگردانده می‌شود.

yad --title "Select Host" --entry --text "Select the host you would like to flood-ping"

نمایش یک کادر گفتگو با پرسش Microsoft Windows has been found! Would you like to remove it?. در صورت انتخاب YES کد بازگشتی 0 (در شل معادل درست/true) و در صورت انتخاب NO مقدار 1 (نادرست/false) خواهد بود.

yad --image "dialog-question" --title "Alert" --button=gtk-yes:0 --button=gtk-no:1 --text "Microsoft Windows has been found! Would you like to remove it?"

نمایش نتایج جستجو در یک کادر گفتگوی فهرستی با عنوان Search Results و متن Finding all header files....

find . -name '*.h' | yad --list --title "Search Results" --text "Finding all header files.." --column "Files"

نمایش یک آیکون در ناحیه اعلان

yad --notification --image=update.png --text "System update necessary!" --command "xterm -e apt-get upgrade"

نمایش یک فهرست خرید هفتگی در یک کادر گفتگوی چک‌لیست با مقادیر از پیش انتخاب‌شده Apples و Oranges

yad --list --checklist --column "Buy" --column "Item" TRUE Apples TRUE Oranges FALSE Pears FALSE Toothpaste

نمایش یک کادر گفتگوی نوار پیشرفت هنگام جستجو برای تمام فایل‌های postscript در دایرکتوری خانگی شما

find $HOME -name '*.ps' | yad --progress --pulsate

نمایش کادری شامل تمام برنامه‌های کاربردی دسکتاپ نصب‌شده

yad --icons --read-dir=/usr/share/applications

نمایش فهرست در حالت درختی

yad --list --tree --column "Items" f Fruits 1:f Apple 2:f Lemon v Vegetables 3:v Popato 4:v Onion

برخی قابلیت‌های ویژه توسعه‌دهندگان به همراه YAD ارائه شده است.

yad-icon-browser [theme]

هنگام استفاده از autoconf می‌توانید از ماکروی ویژه m4 به نام AM_PATH_YAD برای جستجوی yad و بررسی نسخه آن استفاده کنید. نحوه استفاده از این ماکرو به این صورت است:

AM_PATH_YAD([MINIMUM-VERSION],\ [ACTION-IF-FOUND],\ [ACTION-IF-NOT-FOUND])

Yad توسط Victor Ananjevsky <ananasik@gmail.com> نوشته شده است. آیکون Yad توسط Bogdan Lisovich ساخته شده است.

gdialog(1), dialog(1), zenity(1), yad-tools(1)

June 2024 yad