Tkinter dialogs
***************


"tkinter.simpledialog" --- Standard Tkinter input dialogs
=========================================================

**소스 코드:** Lib/tkinter/simpledialog.py

======================================================================

The "tkinter.simpledialog" module contains convenience classes and
functions for creating simple modal dialogs to get a value from the
user.

tkinter.simpledialog.askfloat(title, prompt, *, initialvalue=None, minvalue=None, maxvalue=None, parent=None)
tkinter.simpledialog.askinteger(title, prompt, *, initialvalue=None, minvalue=None, maxvalue=None, parent=None)
tkinter.simpledialog.askstring(title, prompt, *, initialvalue=None, show=None, parent=None)

   Prompt the user to enter a value of the desired type and return it,
   or "None" if the dialog is cancelled.

   *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.
   "askinteger()" and "askfloat()" also accept *minvalue* and
   *maxvalue*, which bound the accepted value. "askstring()" also
   accepts *show*, a character used to mask the entered text, for
   example "'*'" to hide a password.

class tkinter.simpledialog.Dialog(parent, title=None)

   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 "result" attribute.

   result

      The value produced by "apply()", or "None" if the dialog was
      cancelled.

   body(master)

      대화 상자의 인터페이스를 구성하고 초기 포커스가 필요한 위젯을 반
      환하도록 재정의하십시오.

   buttonbox()

      기본 동작은 OK 와 Cancel 버튼을 추가합니다. 사용자 정의 버튼 레
      이아웃이 필요하면 재정의하십시오.

   validate()

      Validate the data entered by the user. Return true if it is
      valid, in which case the dialog proceeds to "apply()"; return
      false to keep the dialog open. The default implementation always
      returns true; override it to check the input.

   apply()

      Process the data entered by the user, for example by storing it
      in the "result" attribute. Called after "validate()" succeeds
      and just before the dialog is destroyed. The default
      implementation does nothing; override it to act on or store the
      result.

   destroy()

      Destroy the dialog window, clearing the reference to the widget
      that had the initial focus.

class tkinter.simpledialog.SimpleDialog(master, text='', buttons=[], default=None, cancel=None, title=None, class_=None)

   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.

   go()

      Display the dialog, wait until the user presses a button or
      closes the window, and return the index of the chosen button.


"tkinter.filedialog" --- File selection dialogs
===============================================

**소스 코드:** Lib/tkinter/filedialog.py

======================================================================

The "tkinter.filedialog" module provides classes and factory functions
for creating file/directory selection windows.


Native load/save dialogs
------------------------

다음 클래스와 함수는 네이티브 모양과 느낌을 동작을 사용자 정의하는 구
성 옵션과 결합하는 파일 대화 상자 창을 제공합니다. 다음 키워드 인자는
아래 나열된 클래스와 함수에 적용할 수 있습니다:

      *parent* - 대화 상자를 그 위에 놓을 창

      *title* - 창의 제목

      *initialdir* - 대화 상자가 시작되는 디렉터리

      *initialfile* - 대화 상자를 열 때 선택된 파일

      *filetypes* - (label, pattern) 튜플의 시퀀스, '*' 와일드카드가 허용됩니다

      *defaultextension* - 파일에 추가할 기본 확장자 (저장 대화 상자)

      *multiple* - 참일 때, 여러 항목을 선택할 수 있습니다

**정적 팩토리 함수**

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.

tkinter.filedialog.askopenfile(mode='r', **options)
tkinter.filedialog.askopenfiles(mode='r', **options)

   Create an "Open" dialog. "askopenfile()" returns the opened file
   object, or "None" if the dialog is cancelled. "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).

tkinter.filedialog.asksaveasfile(mode='w', **options)

   Create a "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).

tkinter.filedialog.askopenfilename(**options)
tkinter.filedialog.askopenfilenames(**options)

   Create an "Open" dialog. "askopenfilename()" returns the selected
   filename as a string, or an empty string if the dialog is
   cancelled. "askopenfilenames()" returns a tuple of the selected
   filenames, or an empty tuple if cancelled.

tkinter.filedialog.asksaveasfilename(**options)

   Create a "SaveAs" dialog and return the selected filename as a
   string, or an empty string if the dialog is cancelled.

tkinter.filedialog.askdirectory(**options)

   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).

class tkinter.filedialog.Open(master=None, **options)
class tkinter.filedialog.SaveAs(master=None, **options)
class tkinter.filedialog.Directory(master=None, **options)

   The above three classes provide native dialog windows for loading
   and saving files and for selecting a directory.

**편의 클래스**

아래 클래스는 파일/디렉터리 창을 처음부터 만드는 데 사용됩니다. 이것들
은 플랫폼의 네이티브 모양과 느낌을 모방하지 않습니다.

참고:

  *FileDialog* 클래스는 사용자 정의 이벤트 처리와 동작을 위해 서브 클
  래싱 되어야 합니다.

class tkinter.filedialog.FileDialog(master, title=None)

   기본 파일 선택 대화 상자를 만듭니다.

   cancel_command(event=None)

      대화 창의 종료를 트리거 합니다.

   dirs_double_event(event)

      디렉터리에 대한 더블 클릭 이벤트를 위한 이벤트 처리기.

   dirs_select_event(event)

      디렉터리에 대한 클릭 이벤트를 위한 이벤트 처리기.

   files_double_event(event)

      파일에 대한 더블 클릭 이벤트를 위한 이벤트 처리기.

   files_select_event(event)

      파일에 대한 단일 클릭 이벤트를 위한 이벤트 처리기.

   filter_command(event=None)

      디렉터리로 파일을 필터링합니다.

   get_filter()

      현재 사용 중인 파일 필터를 가져옵니다.

   get_selection()

      현재 선택된 항목을 가져옵니다.

   go(dir_or_file=os.curdir, pattern='*', default='', key=None)

      대화 상자를 렌더링하고 이벤트 루프를 시작합니다.

   ok_event(event)

      현재 선택을 반환하면서 대화 상자를 종료합니다.

   ok_command()

      Called when the user confirms the current selection. The base
      implementation accepts the selection and closes the dialog;
      "LoadFileDialog" and "SaveFileDialog" override it to check the
      selection first.

   quit(how=None)

      파일명을 (있다면) 반환하면서 대화 상자를 종료합니다.

   set_filter(dir, pat)

      파일 필터를 설정합니다.

   set_selection(file)

      현재 파일 선택을 *file*로 갱신합니다.

class tkinter.filedialog.LoadFileDialog(master, title=None)

   기존 파일을 선택하기 위한 대화 상자 창을 만드는 FileDialog의 서브
   클래스.

   ok_command()

      파일이 제공되고 선택이 이미 존재하는 파일을 가리키는지 테스트합
      니다.

class tkinter.filedialog.SaveFileDialog(master, title=None)

   대상 파일을 선택하기 위한 대화 상자 창을 만드는 FileDialog의 서브
   클래스.

   ok_command()

      선택이 디렉터리가 아닌 유효한 파일을 가리키는지 테스트합니다. 이
      미 존재하는 파일을 선택했으면 확인이 필요합니다.


"tkinter.commondialog" --- Dialog window templates
==================================================

**소스 코드:** Lib/tkinter/commondialog.py

======================================================================

The "tkinter.commondialog" module provides the "Dialog" class that is
the base class for dialogs defined in other supporting modules.

class tkinter.commondialog.Dialog(master=None, **options)

   show(**options)

      대화창을 렌더링합니다.


"tkinter.dialog" --- Classic Tk dialog boxes
============================================

**Source code:** Lib/tkinter/dialog.py

======================================================================

The "tkinter.dialog" module provides a simple modal dialog box built
on the classic (non-themed) Tk widgets.

tkinter.dialog.DIALOG_ICON

   The name of a bitmap ("'questhead'") suitable for use as the
   *bitmap* of a "Dialog".

class tkinter.dialog.Dialog(master=None, cnf={}, **kw)

   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 "DIALOG_ICON"),
   *default* (the index of the default button) and *strings* (the
   sequence of button labels). After construction, the "num" attribute
   holds the index of the button the user pressed.

   destroy()

      Do nothing. The dialog window is destroyed automatically before
      the constructor returns, so there is nothing left for this
      method to do.

더 보기: 모듈 "tkinter.messagebox", Reading and writing files
