xref: /frameworks/base/docs/html-intl/intl/ko/guide/topics/ui/dialogs.jd

page.title=대화
page.tags=alertdialog,dialogfragment

@jd:body



<div id="qv-wrapper">
  <div id="qv">
    <h2>이 문서의 내용</h2>
<ol>
  <li><a href="#DialogFragment">대화 프래그먼트 생성</a></li>
  <li><a href="#AlertDialog">경고 대화 구축</a>
    <ol>
      <li><a href="#AddingButtons">버튼 추가</a></li>
      <li><a href="#AddingAList">목록 추가</a></li>
      <li><a href="#CustomLayout">사용자 지정 레이아웃 생성</a></li>
    </ol>
  </li>
  <li><a href="#PassingEvents">이벤트를 대화의 호스트에 다시 전달</a></li>
  <li><a href="#ShowingADialog">대화 표시</a></li>
  <li><a href="#FullscreenDialog">대화를 전체 화면으로 또는 포함된 프래그먼트로 표시</a>
    <ol>
      <li><a href="#ActivityAsDialog">액티비티를 큰 화면에 대화로 표시</a></li>
    </ol>
  </li>
  <li><a href="#DismissingADialog">대화 무시</a></li>
</ol>

    <h2>Key 클래스</h2>
    <ol>
      <li>{@link android.app.DialogFragment}</li>
      <li>{@link android.app.AlertDialog}</li>
    </ol>

    <h2>참고 항목</h2>
    <ol>
      <li><a href="{@docRoot}design/building-blocks/dialogs.html">대화 디자인 가이드</a></li>
      <li><a href="{@docRoot}guide/topics/ui/controls/pickers.html">선택기</a>(날짜/시간 대화)</li>
    </ol>
  </div>
</div>

<p>대화는 사용자에게 결정을 내리거나 추가 정보를 입력하라는
프롬프트를 보내는 작은 창입니다. 대화는 화면을 가득 채우지 않으며 보통 사용자가
다음으로 계속 진행하기 전에 조치를 취해야 하는 모달 이벤트에 쓰입니다.</p>

<div class="note design">
<p><strong>대화 디자인</strong></p>
  <p>언어 권장 사항을 비롯한 여러 가지 대화 디자인 방법에 관련된 정보는
<a href="{@docRoot}design/building-blocks/dialogs.html">대화</a> 디자인 가이드를 읽어보십시오.</p>
</div>

<img src="{@docRoot}images/ui/dialogs.png" />

<p>{@link android.app.Dialog} 클래스가 대화의 기본 클래스이지만,
{@link android.app.Dialog}를 직접 인스턴트화하는 것은 삼가야 합니다.
대신 다음 하위 클래스 중 하나를 사용하십시오.</p>
<dl>
  <dt>{@link android.app.AlertDialog}</dt>
  <dd>제목 하나, 최대 세 개의 버튼, 선택 가능한 품목 목록 또는
사용자 지정 레이아웃을 표시할 수 있는 대화입니다.</dd>
  <dt>{@link android.app.DatePickerDialog} 또는 {@link android.app.TimePickerDialog}</dt>
  <dd>미리 정의된 UI가 있는 대화로 사용자로 하여금 날짜 또는 시간을 선택할 수 있게 해줍니다.</dd>
</dl>

<div class="sidebox">
<h2>ProgressDialog 피하기</h2>
<p>Android에는
{@link android.app.ProgressDialog}라고 하는 또 다른 대화 클래스가 있습니다. 이것은 진행률 표시줄이 있는 대화를 표시하는 것입니다. 그러나,
로딩이나 확정되지 않은 진행률을 나타내야 하는 경우 이 대신 <a href="{@docRoot}design/building-blocks/progress.html">진행률 및
액티비티</a>에 대한 디자인 지침을 따르고,
레이아웃의 {@link android.widget.ProgressBar}를 사용해야 합니다.</p>
</div>

<p>이러한 클래스가 대화의 스타일과 구조를 정의하지만, 대화의 컨테이너로는
{@link android.support.v4.app.DialogFragment}를 사용해야 합니다.
{@link android.support.v4.app.DialogFragment}
 클래스는 대화를 만들고 그 외관을 관리하는 데 필요한 모든 제어를 제공합니다.
{@link android.app.Dialog} 객체에서 메서드를 호출하는 것 대신입니다.</p>

<p>대화를 관리하기 위해 {@link android.support.v4.app.DialogFragment}를 사용하면
사용자가 <em>뒤로</em> 버튼을 누르거나 화면을 돌릴 때 등
수명 주기 이벤트를 올바르게 처리하도록 보장할 수 있습니다. {@link
android.support.v4.app.DialogFragment} 클래스를 사용하면 대화의 UI를 더 큰 UI에
포함시킬 수 있는 구성 요소로 다시 사용할 수 있게 해주기도 합니다. 이것은 기존의 {@link
android.support.v4.app.Fragment}와 똑같습니다(대화 UI를 크고 작은 화면에서 서로 다르게
나타나도록 하고자 하는 경우 등).</p>

<p>이 가이드의 다음 섹션에서는 {@link
android.support.v4.app.DialogFragment}를 {@link android.app.AlertDialog}
 객체와 함께 조합하여 사용하는 방법을 설명합니다. 날짜 또는 시간 선택기를 생성하고자 하는 경우, 대신
<a href="{@docRoot}guide/topics/ui/controls/pickers.html">선택기</a> 가이드를 읽으십시오.</p>

<p class="note"><strong>참고:</strong>
{@link android.app.DialogFragment} 클래스는 원래
Android 3.0(API 레벨 11)에 추가되었기 때문에 이 문서에서는 <a href="{@docRoot}tools/support-library/index.html">지원 라이브러리</a>와 함께 제공된 {@link
android.support.v4.app.DialogFragment} 클래스를 사용하는 법을 설명합니다. 이 라이브러리를 앱에 추가하면 Android 1.6 이상을 실행하는 기기에서
{@link android.support.v4.app.DialogFragment}를 비롯하여
다른 API도 다양하게 사용할 수 있습니다. 앱의 최소 버전이
API 레벨 11 이상인 경우, {@link
android.app.DialogFragment}의 프레임워크 버전을 사용해도 되지만, 이 문서에 있는 링크는
지원 라이브러리 API를 대상으로 한 것이라는 점을 유의하십시오. 지원 라이브러리를 사용할 때에는
<code>android.support.v4.app.DialogFragment</code>
 클래스를 가져와야 합니다. <code>android.app.DialogFragment</code>가 <em>아닙니다</em>.</p>


<h2 id="DialogFragment">대화 프래그먼트 생성</h2>

<p>대단히 다양한 대화 디자인을 만들 수 있습니다. 사용자 지정 레이아웃은 물론
<a href="{@docRoot}design/building-blocks/dialogs.html">대화</a>
디자인 가이드에서 설명한 것도 포함합니다.
{@link android.support.v4.app.DialogFragment}를 확장하고 {@link android.support.v4.app.DialogFragment#onCreateDialog
onCreateDialog()} 콜백 메서드에 {@link android.app.AlertDialog}를
 생성하면 됩니다.</p>

<p>예를 들어 다음은 {@link android.app.AlertDialog}로, 이는
{@link android.support.v4.app.DialogFragment} 내에서 관리되는 것입니다.</p>

<pre>
public class FireMissilesDialogFragment extends DialogFragment {
    &#64;Override
    public Dialog onCreateDialog(Bundle savedInstanceState) {
        // Use the Builder class for convenient dialog construction
        AlertDialog.Builder builder = new AlertDialog.Builder(getActivity());
        builder.setMessage(R.string.dialog_fire_missiles)
               .setPositiveButton(R.string.fire, new DialogInterface.OnClickListener() {
                   public void onClick(DialogInterface dialog, int id) {
                       // FIRE ZE MISSILES!
                   }
               })
               .setNegativeButton(R.string.cancel, new DialogInterface.OnClickListener() {
                   public void onClick(DialogInterface dialog, int id) {
                       // User cancelled the dialog
                   }
               });
        // Create the AlertDialog object and return it
        return builder.create();
    }
}
</pre>

<div class="figure" style="width:290px;margin:0 0 0 20px">
<img src="{@docRoot}images/ui/dialog_buttons.png" alt="" />
<p class="img-caption"><strong>그림 1.</strong>
메시지 하나와 작업 버튼 두 개가 있는 대화입니다.</p>
</div>

<p>이 클래스의 인스턴스를 생성하고 해당 객체에서 {@link
android.support.v4.app.DialogFragment#show show()}를 호출하면 대화는
그림 1에 표시된 것처럼 나타납니다.</p>

<p>다음 섹션에서는 {@link android.app.AlertDialog.Builder}
API를 사용하여 대화를 생성하는 것에 대해 좀 더 자세히 설명합니다.</p>

<p>대화가 얼마나 복잡한지에 따라
{@link android.support.v4.app.DialogFragment}에서 여러 가지 다른 콜백 메서드를 구현할 수 있습니다. 그중에는 기본적인
<a href="{@docRoot}guide/components/fragments.html#Lifecycle">조각 수명 주기 메서드</a>도 포함됩니다.





<h2 id="AlertDialog">경고 대화 구축</h2>


<p>{@link android.app.AlertDialog} 클래스를 사용하면
여러 가지 대화 디자인을 구축할 수 있으며, 필요한 대화 클래스는 이것뿐인 경우도 많습니다.
그림 2에 표시된 것과 같이 경고 대화에는 세 가지 영역이 있습니다.</p>

<div class="figure" style="width:311px;margin-top:0">
<img src="{@docRoot}images/ui/dialogs_regions.png" alt="" style="margin-bottom:0" />
<p class="img-caption"><strong>그림 2.</strong> 대화의 레이아웃입니다.</p>
</div>

<ol>
<li><b>제목</b>
  <p>이것은 선택 항목이며 콘텐츠 영역에 상세한 메시지, 목록 또는
사용자 지정 레이아웃이 채워져 있는 경우에만 사용해야 합니다. 단순한 메시지 또는
질문(그림 1의 대화처럼)을 진술해야 하는 경우, 제목은 없어도 됩니다.</li>
<li><b>콘텐츠 영역</b>
  <p>이것은 메시지, 목록 또는 다른 사용자 지정 레이아웃을 표시할 수 있습니다.</p></li>
<li><b>작업 버튼</b>
  <p>대화 하나에 작업 버튼은 세 개 이상 있으면 안 됩니다.</p></li>
</ol>

<p>{@link android.app.AlertDialog.Builder}
 클래스가 이와 같은 종류의 콘텐츠가 있는 {@link android.app.AlertDialog}를
 생성할 수 있게 해주는 API를 제공하며, 여기에 사용자 지정 레이아웃도 포함됩니다.</p>

<p>{@link android.app.AlertDialog}를 구축하려면 다음과 같이 하면 됩니다.</p>

<pre>
<b>// 1. Instantiate an {@link android.app.AlertDialog.Builder} with its constructor</b>
AlertDialog.Builder builder = new AlertDialog.Builder(getActivity());

<b>// 2. Chain together various setter methods to set the dialog characteristics</b>
builder.setMessage(R.string.dialog_message)
       .setTitle(R.string.dialog_title);

<b>// 3. Get the {@link android.app.AlertDialog} from {@link android.app.AlertDialog.Builder#create()}</b>
AlertDialog dialog = builder.create();
</pre>

<p>다음 주제는
{@link android.app.AlertDialog.Builder} 클래스를 사용하여 다양한 대화 속성을 정의하는 방법을 나타낸 것입니다.</p>




<h3 id="AddingButtons">버튼 추가</h3>

<p>그림 2에 표시된 것과 같은 작업 버튼을 추가하려면
{@link android.app.AlertDialog.Builder#setPositiveButton setPositiveButton()} 및
{@link android.app.AlertDialog.Builder#setNegativeButton setNegativeButton()} 메서드를 호출하면 됩니다.</p>

<pre style="clear:right">
AlertDialog.Builder builder = new AlertDialog.Builder(getActivity());
// Add the buttons
builder.setPositiveButton(R.string.ok, new DialogInterface.OnClickListener() {
           public void onClick(DialogInterface dialog, int id) {
               // User clicked OK button
           }
       });
builder.setNegativeButton(R.string.cancel, new DialogInterface.OnClickListener() {
           public void onClick(DialogInterface dialog, int id) {
               // User cancelled the dialog
           }
       });
// Set other dialog properties
...

// Create the AlertDialog
AlertDialog dialog = builder.create();
</pre>

<p><code>set...Button()</code> 메서드에는 버튼의 제목이 필요하고(
<a href="{@docRoot}guide/topics/resources/string-resource.html">문자열 리소스</a>가 제공), 사용자가 버튼을 눌렀을 때 수행할 작업을 정의하는
{@link android.content.DialogInterface.OnClickListener}가
필요합니다.</p>

<p>추가할 수 있는 작업 버튼은 다음과 같은 세 가지가 있습니다.</p>
<dl>
  <dt>긍정적</dt>
  <dd>이것은 수락하고 작업을 계속하는 데 사용해야 합니다("확인(OK)" 작업).</dd>
  <dt>부정적</dt>
  <dd>이것은 작업을 취소하는 데 사용해야 합니다.</dd>
  <dt>중립적</dt>
  <dd>이것은 사용자가 작업을 계속하고 싶지 않을 수 있지만
취소하고자 한다고 볼 수 없을 때 사용해야 합니다. 이것은 긍정적 버튼과 부정적 버튼 사이에 나타납니다.
 이런 작업을 예로 들면 "나중에 알림" 등이 있습니다.</dd>
</dl>

<p>{@link
android.app.AlertDialog}에는 각 버튼 유형을 하나씩만 추가할 수 있습니다. 다시 말해, "긍정적" 버튼이 한 개 이상 있으면 안 됩니다.</p>



<div class="figure" style="width:290px;margin:0 0 0 40px">
<img src="{@docRoot}images/ui/dialog_list.png" alt="" />
<p class="img-caption"><strong>그림 3.</strong>
제목과 목록이 있는 대화입니다.</p>
</div>

<h3 id="AddingAList">목록 추가</h3>

<p>{@link android.app.AlertDialog} API와 함께 사용 가능한 목록은 세 가지 종류가 있습니다.</p>
<ul>
<li>일반적인 단일 선택 목록</li>
<li>영구적인 단일 선택 목록(무선 버튼)</li>
<li>영구적인 다중 선택 목록(확인란)</li>
</ul>

<p>그림 3에 표시된 것과 같은 단일 선택 목록을 생성하려면
{@link android.app.AlertDialog.Builder#setItems setItems()} 메서드를 사용하면 됩니다.</p>

<pre style="clear:right">
&#64;Override
public Dialog onCreateDialog(Bundle savedInstanceState) {
    AlertDialog.Builder builder = new AlertDialog.Builder(getActivity());
    builder.setTitle(R.string.pick_color)
           .setItems(R.array.colors_array, new DialogInterface.OnClickListener() {
               public void onClick(DialogInterface dialog, int which) {
               // The 'which' argument contains the index position
               // of the selected item
           }
    });
    return builder.create();
}
</pre>

<p>목록은 대화의 콘텐츠 영역에 나타나므로,
대화는 메시지와 목록을 둘 다 표시할 수 없습니다. 대화에는
{@link android.app.AlertDialog.Builder#setTitle setTitle()}로 제목을 설정해야 합니다.
목록에 대한 항목을 지정하려면 {@link
android.app.AlertDialog.Builder#setItems setItems()}를 호출하여 배열을 하나 전달합니다.
아니면 {@link
android.app.AlertDialog.Builder#setAdapter setAdapter()}를 사용하여 목록을 지정해도 됩니다. 이렇게 하면 동적인 데이터가 있는 목록(예: 데이터베이스에서 가져온 것)을
{@link android.widget.ListAdapter}로 지원할 수 있게 해줍니다.</p>

<p>{@link android.widget.ListAdapter}로 목록을 지원하기로 선택하는 경우,
항상 {@link android.support.v4.content.Loader}를 사용해야 콘텐츠가 비동기식으로
로딩됩니다.
이것은 <a href="{@docRoot}guide/topics/ui/declaring-layout.html#AdapterViews">어댑터로 레이아웃
구축하기</a> 및 <a href="{@docRoot}guide/components/loaders.html">로더</a>
 가이드에 더 자세히 설명되어 있습니다.</p>

<p class="note"><strong>참고:</strong> 기본적으로 목록 항목을 터치하면 대화를 무시하게 됩니다.
다만 다음과 같은 영구적인 선택 목록 중 하나를 사용하는 경우는 예외입니다.</p>

<div class="figure" style="width:290px;margin:-30px 0 0 40px">
<img src="{@docRoot}images/ui/dialog_checkboxes.png" />
<p class="img-caption"><strong>그림 4.</strong>
다중 선택 항목의 목록입니다.</p>
</div>


<h4 id="Checkboxes">영구적 다중 선택 또는 단일 선택 목록 추가</h4>

<p>다중 선택 항목 목록을 추가하거나(확인란)
단일 선택 목록을 추가하려면(무선 버튼), 각각
{@link android.app.AlertDialog.Builder#setMultiChoiceItems(Cursor,String,String,
DialogInterface.OnMultiChoiceClickListener) setMultiChoiceItems()} 또는
{@link android.app.AlertDialog.Builder#setSingleChoiceItems(int,int,DialogInterface.OnClickListener)
setSingleChoiceItems()} 메서드를 사용합니다.</p>

<p>예를 들어 다음은 그림 4에 표시된 것과 같이 다중 선택 목록을 생성하는 방법입니다.
이것은 선택한 항목을
{@link java.util.ArrayList}에 저장합니다.</p>

<pre style="clear:right">
&#64;Override
public Dialog onCreateDialog(Bundle savedInstanceState) {
    mSelectedItems = new ArrayList();  // Where we track the selected items
    AlertDialog.Builder builder = new AlertDialog.Builder(getActivity());
    // Set the dialog title
    builder.setTitle(R.string.pick_toppings)
    // Specify the list array, the items to be selected by default (null for none),
    // and the listener through which to receive callbacks when items are selected
           .setMultiChoiceItems(R.array.toppings, null,
                      new DialogInterface.OnMultiChoiceClickListener() {
               &#64;Override
               public void onClick(DialogInterface dialog, int which,
                       boolean isChecked) {
                   if (isChecked) {
                       // If the user checked the item, add it to the selected items
                       mSelectedItems.add(which);
                   } else if (mSelectedItems.contains(which)) {
                       // Else, if the item is already in the array, remove it
                       mSelectedItems.remove(Integer.valueOf(which));
                   }
               }
           })
    // Set the action buttons
           .setPositiveButton(R.string.ok, new DialogInterface.OnClickListener() {
               &#64;Override
               public void onClick(DialogInterface dialog, int id) {
                   // User clicked OK, so save the mSelectedItems results somewhere
                   // or return them to the component that opened the dialog
                   ...
               }
           })
           .setNegativeButton(R.string.cancel, new DialogInterface.OnClickListener() {
               &#64;Override
               public void onClick(DialogInterface dialog, int id) {
                   ...
               }
           });

    return builder.create();
}
</pre>

<p>일반적인 목록과 무선 버튼이 있는 목록 양쪽 모두 "단일 선택" 작업을
제공하지만, 사용자의 선택을 유지하고자 하는 경우 {@link
android.app.AlertDialog.Builder#setSingleChoiceItems(int,int,DialogInterface.OnClickListener)
setSingleChoiceItems()}를 사용해야 합니다.
다시 말해, 대화를 나중에 다시 여는 경우 사용자의 현재 선택이 무엇인지 나타내야 하며,
그러면 무선 버튼으로 목록을 생성할 수 있습니다.</p>





<h3 id="CustomLayout">사용자 지정 레이아웃 생성</h3>

<div class="figure" style="width:290px;margin:-30px 0 0 40px">
<img src="{@docRoot}images/ui/dialog_custom.png" alt="" />
<p class="img-caption"><strong>그림 5.</strong> 사용자 지정 대화 레이아웃입니다.</p>
</div>

<p>대화에서 사용자 지정 레이아웃을 원하는 경우, 레이아웃을 생성한 다음 이를
{@link android.app.AlertDialog}에 추가하면 됩니다. 이때 {@link
android.app.AlertDialog.Builder#setView setView()} on your {@link
android.app.AlertDialog.Builder} 객체를 호출하는 방법을 씁니다.</p>

<p>기본적으로 사용자 지정 레이아웃이 대화창을 가득 채우지만, 여전히
{@link android.app.AlertDialog.Builder} 메서드를 사용하여 버튼과 제목을 추가할 수 있습니다.</p>

<p>예를 들어 다음은 그림 5에 표시된 대화에 대한 레이아웃 파일입니다.</p>

<p style="clear:right" class="code-caption">res/layout/dialog_signin.xml</p>
<pre>
&lt;LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:orientation="vertical"
    android:layout_width="wrap_content"
    android:layout_height="wrap_content">
    &lt;ImageView
        android:src="@drawable/header_logo"
        android:layout_width="match_parent"
        android:layout_height="64dp"
        android:scaleType="center"
        android:background="#FFFFBB33"
        android:contentDescription="@string/app_name" />
    &lt;EditText
        android:id="@+id/username"
        android:inputType="textEmailAddress"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:layout_marginTop="16dp"
        android:layout_marginLeft="4dp"
        android:layout_marginRight="4dp"
        android:layout_marginBottom="4dp"
        android:hint="@string/username" />
    &lt;EditText
        android:id="@+id/password"
        android:inputType="textPassword"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:layout_marginTop="4dp"
        android:layout_marginLeft="4dp"
        android:layout_marginRight="4dp"
        android:layout_marginBottom="16dp"
        android:fontFamily="sans-serif"
        android:hint="@string/password"/>
&lt;/LinearLayout>
</pre>

<p class="note"><strong>팁:</strong> 기본적으로 {@link android.widget.EditText}
 요소를 설정하여 {@code "textPassword"} 입력 유형을 사용하고자 하는 경우, 글꼴 패밀리가 고정 폭으로 설정되어 있으므로
글꼴 패밀리를 {@code "sans-serif"}로 변경해야 합니다. 그래야 양쪽 텍스트 필드가 모두 일치하는 글꼴 스타일을
사용할 수 있습니다.</p>

<p>{@link android.support.v4.app.DialogFragment} 안의 레이아웃을 팽창시키려면,
{@link android.view.LayoutInflater}를
{@link android.app.Activity#getLayoutInflater()}로 가져와
{@link android.view.LayoutInflater#inflate inflate()}를 호출합니다.
여기서 첫 번째 매개변수가 레이아웃 리소스 ID이고 두 번째 매개변수가 레이아웃의 상위 보기입니다.
그러므로 그런 다음 {@link android.app.AlertDialog#setView setView()}를
 호출하여 레이아웃을 대화에 배치할 수 있습니다.</p>

<pre>
&#64;Override
public Dialog onCreateDialog(Bundle savedInstanceState) {
    AlertDialog.Builder builder = new AlertDialog.Builder(getActivity());
    // Get the layout inflater
    LayoutInflater inflater = getActivity().getLayoutInflater();

    // Inflate and set the layout for the dialog
    // Pass null as the parent view because its going in the dialog layout
    builder.setView(inflater.inflate(R.layout.dialog_signin, null))
    // Add action buttons
           .setPositiveButton(R.string.signin, new DialogInterface.OnClickListener() {
               &#64;Override
               public void onClick(DialogInterface dialog, int id) {
                   // sign in the user ...
               }
           })
           .setNegativeButton(R.string.cancel, new DialogInterface.OnClickListener() {
               public void onClick(DialogInterface dialog, int id) {
                   LoginDialogFragment.this.getDialog().cancel();
               }
           });
    return builder.create();
}
</pre>

<div class="note">
<p><strong>팁:</strong> 사용자 지정 대화를 원하는 경우,
{@link android.app.Activity}를 대신 표시해도 됩니다. 이는
{@link android.app.Dialog} API 대신 대화로 표시하는 것입니다. 단순히 액티비티를 하나 생성한 다음 그 테마를 <a href="{@docRoot}guide/topics/manifest/activity-element.html">{@code
&lt;activity&gt;}</a> 매니페스트 요소에 있는
{@link android.R.style#Theme_Holo_Dialog Theme.Holo.Dialog}로
 설정하면 됩니다.</p>

<pre>
&lt;activity android:theme="&#64;android:style/Theme.Holo.Dialog" >
</pre>
<p>완료되었습니다. 이제 액티비티가 대화를 전체 화면이 아니라 대화창으로 표시합니다.</p>
</div>



<h2 id="PassingEvents">이벤트를 대화의 호스트에 다시 전달</h2>

<p>사용자가 대화의 작업 버튼 중 하나를 터치하거나 목록에서 항목을 하나 선택하면,
{@link android.support.v4.app.DialogFragment}가
필요한 작업을 알아서 수행할 수도 있지만 대부분의 경우 이벤트를 대화를 연 액티비티 또는 프래그먼트에 직접 전달하고자 할 수 있습니다.
 이렇게 하려면 각 클릭 이벤트의 유형별로 메서드가 있는 인터페이스를 정의합니다.
 그런 다음 해당 인터페이스를 대화로부터 작업 이벤트를 수신할
호스트 구성 요소에 구현하면 됩니다.</p>

<p>예를 들어 다음은 인터페이스를 정의하는 {@link android.support.v4.app.DialogFragment}입니다.
이 인터페이스를 통해 이벤트를 호스트 액티비티에 도로 전달하게 됩니다.</p>

<pre>
public class NoticeDialogFragment extends DialogFragment {

    /* The activity that creates an instance of this dialog fragment must
     * implement this interface in order to receive event callbacks.
     * Each method passes the DialogFragment in case the host needs to query it. */
    public interface NoticeDialogListener {
        public void onDialogPositiveClick(DialogFragment dialog);
        public void onDialogNegativeClick(DialogFragment dialog);
    }

    // Use this instance of the interface to deliver action events
    NoticeDialogListener mListener;

    // Override the Fragment.onAttach() method to instantiate the NoticeDialogListener
    &#64;Override
    public void onAttach(Activity activity) {
        super.onAttach(activity);
        // Verify that the host activity implements the callback interface
        try {
            // Instantiate the NoticeDialogListener so we can send events to the host
            mListener = (NoticeDialogListener) activity;
        } catch (ClassCastException e) {
            // The activity doesn't implement the interface, throw exception
            throw new ClassCastException(activity.toString()
                    + " must implement NoticeDialogListener");
        }
    }
    ...
}
</pre>

<p>대화를 호스팅하는 액티비티는 대화의 인스턴스를 만듭니다.
이때 대화 프래그먼트의 생성자를 사용하며,
{@code NoticeDialogListener} 인터페이스 구현을 통해 대화의 이벤트를 수신하게 됩니다.</p>

<pre>
public class MainActivity extends FragmentActivity
                          implements NoticeDialogFragment.NoticeDialogListener{
    ...

    public void showNoticeDialog() {
        // Create an instance of the dialog fragment and show it
        DialogFragment dialog = new NoticeDialogFragment();
        dialog.show(getSupportFragmentManager(), "NoticeDialogFragment");
    }

    // The dialog fragment receives a reference to this Activity through the
    // Fragment.onAttach() callback, which it uses to call the following methods
    // defined by the NoticeDialogFragment.NoticeDialogListener interface
    &#64;Override
    public void onDialogPositiveClick(DialogFragment dialog) {
        // User touched the dialog's positive button
        ...
    }

    &#64;Override
    public void onDialogNegativeClick(DialogFragment dialog) {
        // User touched the dialog's negative button
        ...
    }
}
</pre>

<p>액티비티가 {@code NoticeDialogListener}를 구현하기 때문에&mdash;위에 표시된 {@link android.support.v4.app.Fragment#onAttach onAttach()}
 콜백 메서드가 강제 적용&mdash;해당 대화 프래그먼트는
인터페이스 콜백 메서드를 사용하여 액티비티에 대한 클릭 이벤트를
전달할 수 있습니다.</p>

<pre>
public class NoticeDialogFragment extends DialogFragment {
    ...

    &#64;Override
    public Dialog onCreateDialog(Bundle savedInstanceState) {
        // Build the dialog and set up the button click handlers
        AlertDialog.Builder builder = new AlertDialog.Builder(getActivity());
        builder.setMessage(R.string.dialog_fire_missiles)
               .setPositiveButton(R.string.fire, new DialogInterface.OnClickListener() {
                   public void onClick(DialogInterface dialog, int id) {
                       // Send the positive button event back to the host activity
                       mListener.onDialogPositiveClick(NoticeDialogFragment.this);
                   }
               })
               .setNegativeButton(R.string.cancel, new DialogInterface.OnClickListener() {
                   public void onClick(DialogInterface dialog, int id) {
                       // Send the negative button event back to the host activity
                       mListener.onDialogNegativeClick(NoticeDialogFragment.this);
                   }
               });
        return builder.create();
    }
}
</pre>



<h2 id="ShowingADialog">대화 표시</h2>

<p>대화를 표시하고자 하는 경우, {@link
android.support.v4.app.DialogFragment}의 인스턴스를 생성한 다음 {@link android.support.v4.app.DialogFragment#show
show()}를 호출하여 {@link android.support.v4.app.FragmentManager}와 대화 프래그먼트에 대한
태그 이름을 전달합니다.</p>

<p>{@link android.support.v4.app.FragmentManager}를 가져오려면
{@link android.support.v4.app.FragmentActivity}에서
{@link android.support.v4.app.FragmentActivity#getSupportFragmentManager()}를 호출하거나 {@link
android.support.v4.app.Fragment}로부터 {@link
android.support.v4.app.Fragment#getFragmentManager()}를 호출합니다. 예:</p>

<pre>
public void confirmFireMissiles() {
    DialogFragment newFragment = new FireMissilesDialogFragment();
    newFragment.show(getSupportFragmentManager(), "missiles");
}
</pre>

<p>두 번째 인수 {@code "missiles"}는 시스템이
필요에 따라 프래그먼트의 상태를 저장하고 복원하는 데 사용하는 고유한 태그 이름입니다. 이 태그를 사용하면 {@link android.support.v4.app.FragmentManager#findFragmentByTag
findFragmentByTag()}를 호출하여 해당 프래그먼트를 파악할 수도 있습니다.
</p>




<h2 id="FullscreenDialog">대화를 전체 화면으로 또는 포함된 프래그먼트로 표시</h2>

<p>UI 디자인에서, 몇몇 상황 하에서는 UI의 한 조각을 대화로 나타내지만
다른 상황에서는 전체 화면이나 포함된 프래그먼트로 나타내고자 하는 경우가 있을 수
있습니다(이는 어쩌면 기기 화면이 대형인지 소형인지에 따라 달라질 수도 있습니다). {@link android.support.v4.app.DialogFragment}
클래스에서 이런 유연성을 제공하는 것은 이것이 여전히 포함 가능한 {@link
android.support.v4.app.Fragment} 역할을 할 수 있기 때문입니다.</p>

<p>그러나 이 경우에는 대화를 구축하는 데 {@link android.app.AlertDialog.Builder AlertDialog.Builder}
또는 다른 {@link android.app.Dialog} 객체를 사용하면 안 됩니다.
{@link android.support.v4.app.DialogFragment}를 포함 가능한 상태로 만들려면,
레이아웃 안에 있는 대화의 UI를 정의해야 합니다. 그런 다음 레이아웃을
{@link android.support.v4.app.DialogFragment#onCreateView
onCreateView()} 콜백에 로딩합니다.</p>

<p>다음은 대화 또는 포함 가능한 프래그먼트 중 어느 쪽으로든 표시될 수 있는
{@link android.support.v4.app.DialogFragment} 예시입니다(<code>purchase_items.xml</code>이라는 레이아웃 사용).</p>

<pre>
public class CustomDialogFragment extends DialogFragment {
    /** The system calls this to get the DialogFragment's layout, regardless
        of whether it's being displayed as a dialog or an embedded fragment. */
    &#64;Override
    public View onCreateView(LayoutInflater inflater, ViewGroup container,
            Bundle savedInstanceState) {
        // Inflate the layout to use as dialog or embedded fragment
        return inflater.inflate(R.layout.purchase_items, container, false);
    }

    /** The system calls this only when creating the layout in a dialog. */
    &#64;Override
    public Dialog onCreateDialog(Bundle savedInstanceState) {
        // The only reason you might override this method when using onCreateView() is
        // to modify any dialog characteristics. For example, the dialog includes a
        // title by default, but your custom layout might not need it. So here you can
        // remove the dialog title, but you must call the superclass to get the Dialog.
        Dialog dialog = super.onCreateDialog(savedInstanceState);
        dialog.requestWindowFeature(Window.FEATURE_NO_TITLE);
        return dialog;
    }
}
</pre>

<p>그리고 다음은 프래그먼트를 대화로 표시할지 전체 화면 UI로 표시할지 화면 크기를 근거로 결정하는 몇 가지 코드입니다.
</p>

<pre>
public void showDialog() {
    FragmentManager fragmentManager = getSupportFragmentManager();
    CustomDialogFragment newFragment = new CustomDialogFragment();

    if (mIsLargeLayout) {
        // The device is using a large layout, so show the fragment as a dialog
        newFragment.show(fragmentManager, "dialog");
    } else {
        // The device is smaller, so show the fragment fullscreen
        FragmentTransaction transaction = fragmentManager.beginTransaction();
        // For a little polish, specify a transition animation
        transaction.setTransition(FragmentTransaction.TRANSIT_FRAGMENT_OPEN);
        // To make it fullscreen, use the 'content' root view as the container
        // for the fragment, which is always the root view for the activity
        transaction.add(android.R.id.content, newFragment)
                   .addToBackStack(null).commit();
    }
}
</pre>

<p>프래그먼트 트랜잭션을 수행하는 것에 대한 자세한 내용은
<a href="{@docRoot}guide/components/fragments.html">프래그먼트</a> 가이드를 참조하십시오.</p>

<p>이 예시에서는 <code>mIsLargeLayout</code> 부울이 현재 기기가 앱의 큰 레이아웃 디자인을 써야 할지를
 나타냅니다(따라서 이 프래그먼트를 전체 화면보다는 대화로 표시).
 이런 종류의 부울을 설정하는 가장 좋은 방법은
<a href="{@docRoot}guide/topics/resources/more-resources.html#Bool">부울 리소스 값</a>을
여러 가지 화면 크기에 대한 <a href="{@docRoot}guide/topics/resources/providing-resources.html#AlternativeResources">대체 리소스</a> 값으로 선언하는 것입니다.
예를 들어 다음은 여러 가지 화면 크기에 대한 두 가지 버전의 부울 리소스입니다.</p>

<p class="code-caption">res/values/bools.xml</p>
<pre>
&lt;!-- Default boolean values -->
&lt;resources>
    &lt;bool name="large_layout">false&lt;/bool>
&lt;/resources>
</pre>

<p class="code-caption">res/values-large/bools.xml</p>
<pre>
&lt;!-- Large screen boolean values -->
&lt;resources>
    &lt;bool name="large_layout">true&lt;/bool>
&lt;/resources>
</pre>

<p>그러면 액티비티의
{@link android.app.Activity#onCreate onCreate()} 메서드 중에 {@code mIsLargeLayout} 값을 초기화할 수 있습니다.</p>

<pre>
boolean mIsLargeLayout;

&#64;Override
public void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);

    mIsLargeLayout = getResources().getBoolean(R.bool.large_layout);
}
</pre>



<h3 id="ActivityAsDialog">액티비티를 큰 화면에 대화로 표시</h3>

<p>작은 화면의 경우 대화를 전체 화면 UI로 표시하는 대신, 큰 화면에 있을 때에는
{@link android.app.Activity}를 대화로 표시함으로써 같은 결과를 얻을 수 있습니다.
 어느 방식을 사용할 것인지는 앱 디자인에 따라 달라지지만,
액티비티를 대화로 표시하면 앱이 이미 작은 화면용으로 디자인된 상태에서
태블릿에서의 환경을 개선하기 위해 일시적인 액티비티를 대화로 표시하는 경우
유용할 때가 많습니다.</p>

<p>큰 화면의 경우 액티비티를 대화로만 표시하려면,
{@link android.R.style#Theme_Holo_DialogWhenLarge Theme.Holo.DialogWhenLarge}
 테마를 <a href="{@docRoot}guide/topics/manifest/activity-element.html">{@code
&lt;activity&gt;}</a> 매니페스트 요소에 적용하면 됩니다.</p>

<pre>
&lt;activity android:theme="&#64;android:style/Theme.Holo.DialogWhenLarge" >
</pre>

<p>액티비티를 여러 가지 테마로 스타일링하는 법에 대한 자세한 정보는 <a href="{@docRoot}guide/topics/ui/themes.html">스타일 및 테마</a> 가이드를 참조하십시오.</p>



<h2 id="DismissingADialog">대화 무시</h2>

<p>사용자가
{@link android.app.AlertDialog.Builder}로 생성한 작업 버튼 중 하나라도 터치하면 시스템이 대화를 대신 무시합니다.</p>

<p>시스템은 사용자가 대화 목록에서 항목을 터치하는 경우에도 대화를 무시합니다.
다만 목록이 무선 버튼이나 확인란을 사용하는 경우에는 예외입니다.
그렇지 않으면 대화를 수동으로 무시할 수도 있습니다. {@link
android.support.v4.app.DialogFragment}에서 {@link android.support.v4.app.DialogFragment#dismiss()}를 호출하면 됩니다.</p>

<p>
대화가 사라질 때 특정 작업을 수행해야 하는 경우, {@link
android.support.v4.app.DialogFragment}에서 @link
android.support.v4.app.DialogFragment#onDismiss onDismiss()}를 구현하면 됩니다.</p>

<p>또한 대화를 <em>취소</em>할 수도 있습니다. 이것은 사용자가 작업을 완료하지 않고 대화를
분명히 떠났다는 것을 나타내는 특수 이벤트입니다. 이것은 사용자가
<em>뒤로</em> 버튼을 누르거나 대화 영역 바깥의 화면을 터치하거나,
개발자가 {@link
android.app.Dialog}에서 명시적으로 {@link android.app.Dialog#cancel()}을 호출한 경우 발생합니다(예: 대화의 "취소" 버튼에 대한 응답으로).</p>

<p>위의 예시에 나타난 바와 같이 취소 이벤트에 응답하려면 {@link
android.support.v4.app.DialogFragment} 클래스에서
{@link android.support.v4.app.DialogFragment#onCancel onCancel()}을 구현하면 됩니다.</p>

<p class="note"><strong>참고:</strong> 시스템은
{@link android.support.v4.app.DialogFragment#onCancel onCancel()} 콜백을 불러오는 이벤트가 발생할 때마다
{@link android.support.v4.app.DialogFragment#onDismiss onDismiss()}를 호출합니다.
그러나 {@link android.app.Dialog#dismiss Dialog.dismiss()} 또는 {@link
android.support.v4.app.DialogFragment#dismiss DialogFragment.dismiss()}를 호출하면
시스템은 {@link android.support.v4.app.DialogFragment#onDismiss onDismiss()}는 호출하지만 {@link android.support.v4.app.DialogFragment#onCancel onCancel()}은
호출하지 <em>않습니다</em>. 따라서 사용자가 대화를 보기에서 제거하기 위해 대화에 있는
<em>긍정적인</em> 버튼을 누르는 경우, 일반적으로 {@link android.support.v4.app.DialogFragment#dismiss dismiss()}를
사용해야 합니다.</p>