# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2001 Python Software Foundation
# This file is distributed under the same license as the Python package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
# Translators:
# Revisto <theRevisto@gmail.com>, 2025
# Sepehr Rasouli <sepehrrasouli06@gmail.com>, 2026
#
msgid ""
msgstr ""
"Project-Id-Version: Python 3.14\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2026-09-16 12:56+0000\n"
"PO-Revision-Date: 2026-09-14 09:26+0330\n"
"Last-Translator: Sepehr Rasouli <sepehrrasouli06@gmail.com>, 2026\n"
"Language-Team: Persian (https://github.com/python/python-docs-fa/)\n"
"Language: fa\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Plural-Forms: nplurals=2; plural=(n > 1);\n"
"X-Generator: Poedit 3.6\n"

msgid "Tkinter dialogs"
msgstr "دیالوگ‌های Tkinter"

msgid ":mod:`!tkinter.simpledialog` --- Standard Tkinter input dialogs"
msgstr ":mod:`!tkinter.simpledialog` --- محاوره‌های ورودی استاندارد Tkinter"

msgid "**Source code:** :source:`Lib/tkinter/simpledialog.py`"
msgstr "**کد منبع:** :source:`Lib/tkinter/simpledialog.py`"

msgid "The :mod:`!tkinter.simpledialog` module contains convenience classes and functions for creating simple modal dialogs to get a value from the user."
msgstr "ماژول :mod:`!tkinter.simpledialog` شامل کلاس‌ها و توابع تسهیل‌کننده‌ای برای ایجاد پنجره‌های محاوره‌ای مودال (modal) ساده است تا مقداری را از کاربر دریافت کند."

msgid "Prompt the user to enter a value of the desired type and return it, or ``None`` if the dialog is cancelled."
msgstr "از کاربر برای وارد کردن مقداری از نوع موردنظر درخواست می‌کند و آن را برمی‌گرداند، یا اگر پنجره‌ی محاوره‌ای لغو شود، ``None`` برمی‌گرداند."

msgid "*title* is the dialog title and *prompt* the message shown above the entry. *initialvalue* is the value initially placed in the entry. *parent* is the window over which the dialog is shown. :func:`askinteger` and :func:`askfloat` also accept *minvalue* and *maxvalue*, which bound the accepted value. :func:`askstring` also accepts *show*, a character used to mask the entered text, for example ``'*'`` to hide a password."
msgstr "*title* عنوان محاوره است و *prompt* پیامی است که بالای ورودی نمایش داده می‌شود. *initialvalue* مقداری است که در ابتدا در ورودی قرار داده می‌شود. *parent* پنجره‌ای است که محاوره روی آن نمایش داده می‌شود. :func:`askinteger` و :func:`askfloat` همچنین *minvalue* و *maxvalue* را می‌پذیرند، که مقدار پذیرفته‌شده را محدود می‌کنند. :func:`askstring` همچنین *show* را می‌پذیرد، نویسه‌ای که برای پوشاندن متن واردشده استفاده می‌شود، برای مثال ``'*'`` برای پنهان کردن گذرواژه."

msgid "The base class for custom dialogs. Instantiating it shows the dialog modally and returns once the user closes it; the entered value is then available in the :attr:`!result` attribute."
msgstr "کلاس پایه برای محاوره‌های سفارشی. نمونه‌سازی از آن، محاوره را به‌صورت مودال نمایش می‌دهد و پس از اینکه کاربر آن را ببندد، بازمی‌گردد؛ سپس مقدار واردشده در ویژگی :attr:`!result` در دسترس است."

msgid "The value produced by :meth:`apply`, or ``None`` if the dialog was cancelled."
msgstr "مقدار حاصل از :meth:`apply`، یا ``None`` اگر محاوره لغو شده باشد."

msgid "Override to construct the dialog's interface and return the widget that should have initial focus."
msgstr "بازنویسی کنید تا رابط دیالوگ را بسازد و ابزارکی که باید فوکوس اولیه را داشته باشد برگرداند."

msgid "Default behaviour adds OK and Cancel buttons. Override for custom button layouts."
msgstr "رفتار پیش‌فرض، دکمه‌های OK و Cancel را اضافه می‌کند. برای چیدمان‌های سفارشی دکمه‌ها، آن را بازنویسی کنید."

msgid "Validate the data entered by the user. Return true if it is valid, in which case the dialog proceeds to :meth:`apply`; return false to keep the dialog open. The default implementation always returns true; override it to check the input."
msgstr "داده واردشده توسط کاربر را اعتبارسنجی کنید. اگر معتبر باشد، true را برگردانید، که در این صورت محاوره به :meth:`apply` می‌رود؛ برای باز نگه‌داشتن محاوره، false را برگردانید. پیاده‌سازی پیش‌فرض همیشه true را برمی‌گرداند؛ برای بررسی ورودی، آن را بازنویسی کنید."

msgid "Process the data entered by the user, for example by storing it in the :attr:`!result` attribute. Called after :meth:`validate` succeeds and just before the dialog is destroyed. The default implementation does nothing; override it to act on or store the result."
msgstr "داده‌های واردشده توسط کاربر را پردازش کنید، برای مثال با ذخیره‌ی آن‌ها در ویژگی :attr:`!result`. پس از موفقیت :meth:`validate` و درست پیش از تخریب محاوره فراخوانی می‌شود. پیاده‌سازی پیش‌فرض هیچ کاری انجام نمی‌دهد؛ آن را بازنویسی کنید تا بر اساس نتیجه عمل کند یا آن را ذخیره کند."

msgid "Destroy the dialog window, clearing the reference to the widget that had the initial focus."
msgstr "پنجره‌ی محاوره را از بین می‌برد و ارجاع به ابزارکی که فوکوس اولیه را داشت پاک می‌کند."

msgid "A simple modal dialog that displays the message *text* above a row of push buttons whose labels are given by *buttons*, and returns the index of the button the user presses. *default* is the index of the button activated by the Return key, *cancel* the index returned when the window is closed through the window manager, *title* the window title, and *class_* the Tk class name of the window."
msgstr "یک پنجره‌ی محاوره‌ای مودال ساده که پیام *text* را بالای ردیفی از دکمه‌های فشاری نمایش می‌دهد که برچسب‌های آن‌ها با *buttons* مشخص شده‌اند، و اندیس دکمه‌ای را که کاربر فشار می‌دهد برمی‌گرداند. *default* اندیس دکمه‌ای است که با کلید Return فعال می‌شود، *cancel* اندیسی است که هنگام بسته شدن پنجره از طریق مدیر پنجره برگردانده می‌شود، *title* عنوان پنجره است، و *class_* نام کلاس Tk پنجره است."

msgid "Display the dialog, wait until the user presses a button or closes the window, and return the index of the chosen button."
msgstr "محاوره را نمایش دهید، منتظر بمانید تا کاربر دکمه‌ای را فشار دهد یا پنجره را ببندد، و اندیس دکمه‌ی انتخاب‌شده را برگردانید."

msgid ":mod:`!tkinter.filedialog` --- File selection dialogs"
msgstr ":mod:`!tkinter.filedialog` --- محاوره‌های انتخاب پرونده"

msgid "**Source code:** :source:`Lib/tkinter/filedialog.py`"
msgstr "**کد منبع:** :source:`Lib/tkinter/filedialog.py`"

msgid "The :mod:`!tkinter.filedialog` module provides classes and factory functions for creating file/directory selection windows."
msgstr "ماژول :mod:`!tkinter.filedialog` کلاس‌ها و توابع کارخانه‌ای (factory functions) را برای ایجاد پنجره‌های انتخاب پرونده/پوشه ارائه می‌دهد."

msgid "Native load/save dialogs"
msgstr "محاوره‌های بومی بارگذاری/ذخیره"

msgid "The following classes and functions provide file dialog windows that combine a native look-and-feel with configuration options to customize behaviour. The following keyword arguments are applicable to the classes and functions listed below:"
msgstr "کلاس‌ها و توابع زیر پنجره‌های محاوره‌ای پرونده را فراهم می‌کنند که ظاهر و رفتار بومی را با گزینه‌های پیکربندی برای سفارشی‌سازی رفتار ترکیب می‌کنند. آرگومان‌های کلیدواژه‌ای زیر بر کلاس‌ها و توابع فهرست‌شده در زیر قابل اعمال هستند:"

msgid "*parent* - the window to place the dialog on top of"
msgstr "*parent* - پنجره‌ای که محاوره روی آن قرار می‌گیرد"

msgid "*title* - the title of the window"
msgstr "*title* - عنوان پنجره"

msgid "*initialdir* - the directory that the dialog starts in"
msgstr "*initialdir* - پوشه‌ای که پنجره‌ی محاوره‌ای در آن آغاز می‌شود"

msgid "*initialfile* - the file selected upon opening of the dialog"
msgstr "*initialfile* - پرونده انتخاب‌شده هنگام باز شدن دیالوگ"

msgid "*filetypes* - a sequence of (label, pattern) tuples, '*' wildcard is allowed"
msgstr "*filetypes* - دنباله‌ای از تاپل‌های (label, pattern)، وایلدکارد '*' مجاز است"

msgid "*defaultextension* - default extension to append to file (save dialogs)"
msgstr "*defaultextension* - پسوند پیش‌فرض برای افزودن به پرونده (پنجره‌های محاوره‌ای ذخیره)"

msgid "*multiple* - when true, selection of multiple items is allowed"
msgstr "*multiple* - هنگامی که true باشد، انتخاب چند آیتم مجاز است"

msgid "**Static factory functions**"
msgstr "توابع کارخانه‌ای ایستا"

msgid "The below functions when called create a modal, native look-and-feel dialog, wait for the user's selection, and return it. The exact return value depends on the function (see below); when the dialog is cancelled it is an empty string, an empty tuple or ``None``. The precise type of this empty value may vary between platforms and Tk versions, so test the result for truth rather than comparing it with a specific value."
msgstr "توابع زیر هنگام فراخوانی، یک پنجره محاوره‌ای مودال (modal) با ظاهر و رفتار بومی ایجاد می‌کنند، منتظر انتخاب کاربر می‌مانند و آن را برمی‌گردانند. مقدار بازگشتی دقیق به تابع بستگی دارد (در زیر ببینید)؛ هنگامی که پنجره محاوره‌ای لغو می‌شود، این مقدار یک رشته خالی، یک تاپل خالی یا ``None`` است. نوع دقیق این مقدار خالی ممکن است بین سکوها و نسخه‌های Tk متفاوت باشد، بنابراین به‌جای مقایسه آن با یک مقدار خاص، درستی نتیجه را بسنجید."

msgid "Create an :class:`Open` dialog. :func:`askopenfile` returns the opened file object, or ``None`` if the dialog is cancelled. :func:`askopenfiles` returns a list of the opened file objects, or an empty tuple if cancelled. The files are opened in mode *mode* (read-only ``'r'`` by default)."
msgstr "یک پنجره‌ی محاوره‌ای :class:`Open` ایجاد کنید. :func:`askopenfile` شیء پرونده بازشده را برمی‌گرداند، یا اگر پنجره‌ی محاوره‌ای لغو شود، ``None`` را برمی‌گرداند. :func:`askopenfiles` فهرستی از اشیای پرونده بازشده را برمی‌گرداند، یا در صورت لغو شدن، یک تاپل خالی را برمی‌گرداند. پرونده‌ها در حالت *mode* باز می‌شوند (به‌طور پیش‌فرض، حالت فقط‌خواندنی ``'r'``)."

msgid "Create a :class:`SaveAs` dialog and return the opened file object, or ``None`` if the dialog is cancelled. The file is opened in mode *mode* (``'w'`` by default)."
msgstr "یک پنجره‌ی محاوره‌ای :class:`SaveAs` ایجاد می‌کند و شیء پرونده بازشده را برمی‌گرداند، یا اگر پنجره‌ی محاوره‌ای لغو شود، ``None`` را برمی‌گرداند. پرونده در حالت *mode* باز می‌شود (به‌طور پیش‌فرض ``'w'``)."

msgid "Create an :class:`Open` dialog. :func:`askopenfilename` returns the selected filename as a string, or an empty string if the dialog is cancelled. :func:`askopenfilenames` returns a tuple of the selected filenames, or an empty tuple if cancelled."
msgstr "یک پنجره‌ی محاوره‌ای :class:`Open` ایجاد کنید. :func:`askopenfilename` نام پرونده انتخاب‌شده را به‌صورت یک رشته برمی‌گرداند، یا اگر پنجره‌ی محاوره‌ای لغو شود، یک رشته‌ی خالی برمی‌گرداند. :func:`askopenfilenames` یک تاپل از نام پرونده‌های انتخاب‌شده برمی‌گرداند، یا در صورت لغو، یک تاپل خالی برمی‌گرداند."

msgid "Create a :class:`SaveAs` dialog and return the selected filename as a string, or an empty string if the dialog is cancelled."
msgstr "یک پنجره‌ی محاوره‌ای :class:`SaveAs` ایجاد کنید و نام پرونده انتخاب‌شده را به‌عنوان یک رشته برگردانید، یا اگر پنجره‌ی محاوره‌ای لغو شد، یک رشته‌ی خالی برگردانید."

msgid "Prompt the user to select a directory, and return its path as a string, or an empty string if the dialog is cancelled. Additional keyword option: *mustexist* - if true, the user may only select an existing directory (false by default)."
msgstr "از کاربر برای انتخاب یک پوشه درخواست می‌کند و مسیر آن را به‌صورت یک رشته برمی‌گرداند، یا اگر پنجره‌ی گفتگو لغو شود، یک رشته خالی برمی‌گرداند. گزینه کلیدواژه‌ای اضافی: *mustexist* - اگر true باشد، کاربر فقط می‌تواند یک پوشه‌ی موجود را انتخاب کند (به‌طور پیش‌فرض false است)."

msgid "The above three classes provide native dialog windows for loading and saving files and for selecting a directory."
msgstr "سه کلاس بالا، پنجره‌های محاوره‌ای بومی را برای بارگذاری و ذخیره پرونده‌ها و برای انتخاب یک پوشه فراهم می‌کنند."

msgid "**Convenience classes**"
msgstr "کلاس‌های راحتی"

msgid "The below classes are used for creating file/directory windows from scratch. These do not emulate the native look-and-feel of the platform."
msgstr "کلاس‌های زیر برای ایجاد پنجره‌های پرونده/پوشه از صفر استفاده می‌شوند. این‌ها ظاهر و رفتار بومی پلتفرم را شبیه‌سازی نمی‌کنند."

msgid "The *FileDialog* class should be subclassed for custom event handling and behaviour."
msgstr "برای مدیریت رویداد و رفتار سفارشی، باید از کلاس *FileDialog* زیرکلاس ساخته شود."

msgid "Create a basic file selection dialog."
msgstr "یک محاوره‌ی انتخاب پرونده ساده ایجاد کنید."

msgid "Trigger the termination of the dialog window."
msgstr "باعث پایان یافتن پنجره‌ی محاوره‌ای شوید."

msgid "Event handler for double-click event on directory."
msgstr "هندلر رویداد دوبارکلیک روی پوشه."

msgid "Event handler for click event on directory."
msgstr "هندلر رویداد برای رویداد کلیک روی پوشه."

msgid "Event handler for double-click event on file."
msgstr "هندلر رویداد برای رویداد دوبارکلیک روی پرونده."

msgid "Event handler for single-click event on file."
msgstr "هندلر رویداد برای رویداد تک‌کلیک روی پرونده."

msgid "Filter the files by directory."
msgstr "پرونده‌ها را بر اساس پوشه فیلتر کنید."

msgid "Retrieve the file filter currently in use."
msgstr "فیلتر پرونده در حال استفاده را دریافت کنید."

msgid "Retrieve the currently selected item."
msgstr "آیتم انتخاب‌شده‌ی فعلی را بازیابی کنید."

msgid "Render dialog and start event loop."
msgstr "دیالوگ را ترسیم کنید و حلقه رویداد را آغاز کنید."

msgid "Exit dialog returning current selection."
msgstr "خروج از پنجره‌ی محاوره با برگرداندن انتخاب فعلی."

msgid "Called when the user confirms the current selection. The base implementation accepts the selection and closes the dialog; :class:`LoadFileDialog` and :class:`SaveFileDialog` override it to check the selection first."
msgstr "هنگامی که کاربر انتخاب فعلی را تأیید می‌کند، فراخوانی می‌شود. پیاده‌سازی پایه انتخاب را می‌پذیرد و پنجره‌ی محاوره‌ای را می‌بندد؛ :class:`LoadFileDialog` و :class:`SaveFileDialog` آن را بازنویسی می‌کنند تا ابتدا انتخاب را بررسی کنند."

msgid "Exit dialog returning filename, if any."
msgstr "دیالوگ خروج خارج می‌شود و در صورت وجود، نام پرونده را برمی‌گرداند."

msgid "Set the file filter."
msgstr "فیلتر پرونده را تنظیم کنید."

msgid "Update the current file selection to *file*."
msgstr "انتخاب پرونده جاری را به *file* به‌روزرسانی کنید."

msgid "A subclass of FileDialog that creates a dialog window for selecting an existing file."
msgstr "یک زیرکلاس از FileDialog که یک پنجره‌ی محاوره‌ای برای انتخاب یک پرونده موجود ایجاد می‌کند."

msgid "Test that a file is provided and that the selection indicates an already existing file."
msgstr "آزمایش کنید که پرونده‌ای ارائه‌شده باشد و انتخاب، نشان‌دهنده‌ی یک پرونده از قبل موجود باشد."

msgid "A subclass of FileDialog that creates a dialog window for selecting a destination file."
msgstr "زیرکلاسی از FileDialog که یک پنجره‌ی محاوره‌ای برای انتخاب پرونده مقصد ایجاد می‌کند."

msgid "Test whether or not the selection points to a valid file that is not a directory. Confirmation is required if an already existing file is selected."
msgstr "بررسی می‌کند که آیا مورد انتخاب‌شده به یک پرونده معتبر اشاره می‌کند که پوشه نیست یا خیر. اگر یک پرونده از پیش موجود انتخاب شده باشد، تأیید لازم است."

msgid ":mod:`!tkinter.commondialog` --- Dialog window templates"
msgstr ":mod:`!tkinter.commondialog` --- قالب‌های پنجره محاوره‌ای"

msgid "**Source code:** :source:`Lib/tkinter/commondialog.py`"
msgstr "**کد منبع:** :source:`Lib/tkinter/commondialog.py`"

msgid "The :mod:`!tkinter.commondialog` module provides the :class:`Dialog` class that is the base class for dialogs defined in other supporting modules."
msgstr "ماژول :mod:`!tkinter.commondialog` کلاس :class:`Dialog` را فراهم می‌کند که کلاس پایه برای محاوره‌های تعریف‌شده در سایر ماژول‌های پشتیبانی است."

msgid "Render the Dialog window."
msgstr "پنجره‌ی Dialog را رندر کنید."

msgid ":mod:`!tkinter.dialog` --- Classic Tk dialog boxes"
msgstr ":mod:`!tkinter.dialog` --- جعبه‌های محاوره‌ای کلاسیک Tk"

msgid "**Source code:** :source:`Lib/tkinter/dialog.py`"
msgstr "**کد منبع:** :source:`Lib/tkinter/dialog.py`"

msgid "The :mod:`!tkinter.dialog` module provides a simple modal dialog box built on the classic (non-themed) Tk widgets."
msgstr "ماژول :mod:`!tkinter.dialog` یک جعبه‌ی محاوره‌ی مودال ساده ارائه می‌دهد که مبتنی بر ابزارک‌های کلاسیک Tk (بدون تم) است."

msgid "The name of a bitmap (``'questhead'``) suitable for use as the *bitmap* of a :class:`Dialog`."
msgstr "نام یک بیت‌مپ (``'questhead'``) مناسب برای استفاده به‌عنوان *bitmap* یک :class:`Dialog`."

msgid "Display a modal dialog box built from the classic (non-themed) Tk widgets and wait for the user to press one of its buttons. The options, given through *cnf* or as keyword arguments, are all required: *title* (the window title), *text* (the message), *bitmap* (the name of a bitmap icon, such as :data:`DIALOG_ICON`), *default* (the index of the default button) and *strings* (the sequence of button labels). After construction, the :attr:`!num` attribute holds the index of the button the user pressed."
msgstr "یک جعبه محاوره‌ای مودال ساخته‌شده از ابزارک‌های کلاسیک Tk (بدون تم) را نمایش می‌دهد و منتظر می‌ماند تا کاربر یکی از دکمه‌های آن را فشار دهد. گزینه‌ها، که از طریق *cnf* یا به‌صورت آرگومان‌های کلیدواژه‌ای داده می‌شوند، همه الزامی هستند: *title* (عنوان پنجره)، *text* (پیام)، *bitmap* (نام یک آیکون بیت‌مپ، مانند :data:`DIALOG_ICON`)، *default* (اندیس دکمه پیش‌فرض) و *strings* (دنباله‌ای از برچسب‌های دکمه). پس از ساخت، ویژگی :attr:`!num` حاوی اندیس دکمه‌ای است که کاربر فشار داده است."

msgid "Do nothing. The dialog window is destroyed automatically before the constructor returns, so there is nothing left for this method to do."
msgstr "هیچ کاری انجام نمی‌دهد. پنجره‌ی محاوره‌ای به‌طور خودکار پیش از بازگشت سازنده تخریب می‌شود، بنابراین هیچ کاری برای این متد باقی نمی‌ماند."

msgid "Modules :mod:`tkinter.messagebox`, :ref:`tut-files`"
msgstr "ماژول‌ها :mod:`tkinter.messagebox`، :ref:`tut-files`"