이 문서는 기계 번역을 이용하여 번역되었습니다. 문서를 영문으로 보려면 영문 확인란을 선택하세요. 마우스 포인터를 텍스트 위로 이동시켜 팝업 창에서 영문 텍스트를 표시할 수도 있습니다.
번역
영문

FolderBrowserDialog 클래스

 

게시 날짜: 2016년 11월

폴더를 선택 하 라는 메시지입니다. 이 클래스는 상속될 수 없습니다.

네임스페이스:   System.Windows.Forms
어셈블리:  System.Windows.Forms(System.Windows.Forms.dll에 있음)

System.Object
  System.MarshalByRefObject
    System.ComponentModel.Component
      System.Windows.Forms.CommonDialog
        System.Windows.Forms.FolderBrowserDialog

public sealed class FolderBrowserDialog : CommonDialog

이름설명
System_CAPS_pubmethodFolderBrowserDialog()

FolderBrowserDialog 클래스의 새 인스턴스를 초기화합니다.

이름설명
System_CAPS_pubpropertyContainer

IContainer 를 가져옵니다. ( Component를 포함) (Component에서 상속됨)

System_CAPS_pubpropertyDescription

대화 상자에서 트리 뷰 컨트롤 위에 표시 된 설명 텍스트를 가져오거나 설정 합니다.

System_CAPS_pubpropertyRootFolder

검색 시작 되는 위치에서 루트 폴더를 가져오거나 설정 합니다.

System_CAPS_pubpropertySelectedPath

사용자가 선택한 경로 가져오거나 설정 합니다.

System_CAPS_pubpropertyShowNewFolderButton

나타내는 값을 가져오거나 여부는 새 폴더 폴더 찾아보기 대화 상자에 단추가 나타납니다.

System_CAPS_pubpropertySite

가져오거나는 ISiteComponent합니다.(Component에서 상속됨)

System_CAPS_pubpropertyTag

컨트롤에 대 한 데이터를 포함 하는 개체를 가져오거나 설정 합니다.(CommonDialog에서 상속됨)

이름설명
System_CAPS_pubmethodCreateObjRef(Type)

원격 개체와 통신 하는 데 프록시를 생성 하는 데 필요한 모든 관련 정보를 포함 하는 개체를 만듭니다.(MarshalByRefObject에서 상속됨)

System_CAPS_pubmethodDispose()

Component에서 사용하는 모든 리소스를 해제합니다.(Component에서 상속됨)

System_CAPS_pubmethodEquals(Object)

지정한 개체가 현재 개체와 같은지 여부를 확인합니다. (Object에서 상속됨)

System_CAPS_pubmethodGetHashCode()

기본 해시 함수로 작동합니다.(Object에서 상속됨)

System_CAPS_pubmethodGetLifetimeService()

이 인스턴스에 대 한 수명 정책을 제어 하는 수명이 현재 서비스 개체를 검색 합니다.(MarshalByRefObject에서 상속됨)

System_CAPS_pubmethodGetType()

현재 인스턴스의 Type을 가져옵니다.(Object에서 상속됨)

System_CAPS_pubmethodInitializeLifetimeService()

이 인스턴스의 수명 정책을 제어하는 수명 서비스 개체를 가져옵니다.(MarshalByRefObject에서 상속됨)

System_CAPS_pubmethodReset()

속성을 기본값으로 다시 설정합니다.(CommonDialog.Reset()을(를) 재정의함)

System_CAPS_pubmethodShowDialog()

기본 소유자로 일반 대화 상자를 실행합니다.(CommonDialog에서 상속됨)

System_CAPS_pubmethodShowDialog(IWin32Window)

지정된 소유자로 일반 대화 상자를 실행합니다.(CommonDialog에서 상속됨)

System_CAPS_pubmethodToString()

반환 된 String 의 이름을 포함 하는 Component, 있는 경우. 이 메서드는 재정의할 수 없습니다.(Component에서 상속됨)

이름설명
System_CAPS_pubeventDisposed

구성 요소를 호출 하 여 삭제 될 때 발생 된 Dispose 메서드.(Component에서 상속됨)

System_CAPS_pubeventHelpRequest

이 API는 제품 인프라를 지원하며 코드에서 직접 사용할 수 없습니다. 사용자가 클릭할 때 발생 된 도움말 대화 상자에서 단추 합니다.

이 클래스에는 찾아보기, 작성 및 결국 폴더를 선택 하 라는 메시지가 하는 방법을 제공 합니다. 사용자 파일이 아닌 폴더를 선택 하도록 허용 하려는 경우에이 클래스를 사용 합니다. 폴더 찾아보기 트리 컨트롤을 통해 수행 됩니다. 파일 시스템에서 폴더 중 하나만 선택할 수 있습니다. 가상 폴더는 다음 작업을 할 수 없습니다.

새를 만든 후 일반적으로 FolderBrowserDialog, 설정한는 RootFolder 에서 검색을 시작할 위치입니다. 설정할 수 있습니다는 SelectedPath 의 하위 폴더의 절대 경로를 RootFolder 처음 선택할 수 있습니다. 또한 필요에 따라 설정할 수는 Description 속성을 사용자에 게 추가 지침을 제공 합니다. 마지막으로 호출 된 ShowDialog 메서드를 사용자에 게 대화 상자를 표시 합니다. 대화 상자를 닫을 때 및 대화 상자 결과가 ShowDialogDialogResult.OK, SelectedPath 선택한 폴더의 경로를 포함 하는 문자열이 됩니다.

사용할 수는 ShowNewFolderButton 속성을 제어 하는 경우 사용자가 사용 하 여 새 폴더를 만들 수는 새 폴더 단추입니다.

FolderBrowserDialog 모달 대화 상자입니다. 따라서 표시 된 사용자가 폴더를 선택 될 때까지 응용 프로그램의 나머지 부분을 차단 됩니다. 대화 상자 모달 형식으로 표시 되 면 (키보드 또는 마우스 클릭)를 입력 하지 않고 대화 상자에 있는 개체를 제외 하 고 발생할 수 있습니다. 프로그램 숨기 거 나 close 호출 프로그램에 입력 하기 전에 대화 상자 (일반적으로 사용자의 일부 동작에 대 한 응답)에서 발생할 수 있습니다.

다음 코드 예제에서는 사용자가 내에서 서식 있는 텍스트 (.rtf) 파일을 열 수 있도록 응용 프로그램을 만듭니다는 RichTextBox 제어 합니다.

// The following example displays an application that provides the ability to 
// open rich text files (rtf) into the RichTextBox. The example demonstrates 
// using the FolderBrowserDialog to set the default directory for opening files.
// The OpenFileDialog class is used to open the file.
using System;
using System.Drawing;
using System.Windows.Forms;
using System.IO;

public class FolderBrowserDialogExampleForm : System.Windows.Forms.Form
{
    private FolderBrowserDialog folderBrowserDialog1;
    private OpenFileDialog openFileDialog1;

    private RichTextBox richTextBox1;

    private MainMenu mainMenu1;
    private MenuItem fileMenuItem, openMenuItem;
    private MenuItem folderMenuItem, closeMenuItem;

    private string openFileName, folderName;

    private bool fileOpened = false;

    // The main entry point for the application.
    [STAThreadAttribute]
    static void Main() 
    {
        Application.Run(new FolderBrowserDialogExampleForm());
    }


    // Constructor.
    public FolderBrowserDialogExampleForm()
    {
        this.mainMenu1 = new System.Windows.Forms.MainMenu();
        this.fileMenuItem = new System.Windows.Forms.MenuItem();
        this.openMenuItem = new System.Windows.Forms.MenuItem();
        this.folderMenuItem = new System.Windows.Forms.MenuItem();
        this.closeMenuItem = new System.Windows.Forms.MenuItem();

        this.openFileDialog1 = new System.Windows.Forms.OpenFileDialog();
        this.folderBrowserDialog1 = new System.Windows.Forms.FolderBrowserDialog();
        this.richTextBox1 = new System.Windows.Forms.RichTextBox();

        this.mainMenu1.MenuItems.Add(this.fileMenuItem);
        this.fileMenuItem.MenuItems.AddRange(
                            new System.Windows.Forms.MenuItem[] {this.openMenuItem,
                                                                 this.closeMenuItem,
                                                                 this.folderMenuItem});
        this.fileMenuItem.Text = "File";

        this.openMenuItem.Text = "Open...";
        this.openMenuItem.Click += new System.EventHandler(this.openMenuItem_Click);

        this.folderMenuItem.Text = "Select Directory...";
        this.folderMenuItem.Click += new System.EventHandler(this.folderMenuItem_Click);

        this.closeMenuItem.Text = "Close";
        this.closeMenuItem.Click += new System.EventHandler(this.closeMenuItem_Click);
        this.closeMenuItem.Enabled = false;

        this.openFileDialog1.DefaultExt = "rtf";
        this.openFileDialog1.Filter = "rtf files (*.rtf)|*.rtf";

        // Set the help text description for the FolderBrowserDialog.
        this.folderBrowserDialog1.Description = 
            "Select the directory that you want to use as the default.";

        // Do not allow the user to create new files via the FolderBrowserDialog.
        this.folderBrowserDialog1.ShowNewFolderButton = false;

        // Default to the My Documents folder.
        this.folderBrowserDialog1.RootFolder = Environment.SpecialFolder.Personal;

        this.richTextBox1.AcceptsTab = true;
        this.richTextBox1.Location = new System.Drawing.Point(8, 8);
        this.richTextBox1.Size = new System.Drawing.Size(280, 344);
        this.richTextBox1.Anchor = AnchorStyles.Top | AnchorStyles.Left | 
                                   AnchorStyles.Bottom | AnchorStyles.Right;

        this.ClientSize = new System.Drawing.Size(296, 360);
        this.Controls.Add(this.richTextBox1);
        this.Menu = this.mainMenu1;
        this.Text = "RTF Document Browser";
    }

    // Bring up a dialog to open a file.
    private void openMenuItem_Click(object sender, System.EventArgs e)
    {
        // If a file is not opened, then set the initial directory to the
        // FolderBrowserDialog.SelectedPath value.
        if (!fileOpened) {
            openFileDialog1.InitialDirectory = folderBrowserDialog1.SelectedPath;
            openFileDialog1.FileName = null;
        }

        // Display the openFile dialog.
        DialogResult result = openFileDialog1.ShowDialog();

        // OK button was pressed.
        if(result == DialogResult.OK) 
        {
            openFileName = openFileDialog1.FileName;
            try
            {
                // Output the requested file in richTextBox1.
                Stream s = openFileDialog1.OpenFile();
                richTextBox1.LoadFile(s, RichTextBoxStreamType.RichText);
                s.Close();    

                fileOpened = true;

            } 
            catch(Exception exp)
            {
                MessageBox.Show("An error occurred while attempting to load the file. The error is:" 
                                + System.Environment.NewLine + exp.ToString() + System.Environment.NewLine);
                fileOpened = false;
            }
            Invalidate();

            closeMenuItem.Enabled = fileOpened;
        }

        // Cancel button was pressed.
        else if(result == DialogResult.Cancel) 
        {
            return;
        }
    }


    // Close the current file.
    private void closeMenuItem_Click(object sender, System.EventArgs e)
    {
        richTextBox1.Text = "";
        fileOpened = false;

        closeMenuItem.Enabled = false;
    }


    // Bring up a dialog to chose a folder path in which to open or save a file.
    private void folderMenuItem_Click(object sender, System.EventArgs e)
    {
        // Show the FolderBrowserDialog.
        DialogResult result = folderBrowserDialog1.ShowDialog();
        if( result == DialogResult.OK )
        {
            folderName = folderBrowserDialog1.SelectedPath;
            if(!fileOpened)
            {
                // No file is opened, bring up openFileDialog in selected path.
                openFileDialog1.InitialDirectory = folderName;
                openFileDialog1.FileName = null;
                openMenuItem.PerformClick();
            } 
        }
    }
}

.NET Framework
1.1 이후 사용 가능

이 형식의 모든 public static(Visual Basic의 공유 Visual Basic의 경우) 멤버는 스레드로부터 안전합니다. 인스턴스 멤버는 스레드로부터의 안전이 보장되지 않습니다.

맨 위로 이동
표시: