CMFCEditBrowseCtrl 클래스

아티클
06/16/2023

클래스는 CMFCEditBrowseCtrl 선택적으로 찾아보기 단추를 포함하는 편집 가능한 텍스트 상자인 편집 찾아보기 컨트롤을 지원합니다. 사용자가 찾아보기 단추를 클릭하면 컨트롤은 사용자 지정 작업을 수행하거나 파일 브라우저 또는 폴더 브라우저가 포함된 표준 대화 상자를 표시합니다.

구문

class CMFCEditBrowseCtrl : public CEdit

멤버

공용 생성자

속성	설명
`CMFCEditBrowseCtrl::CMFCEditBrowseCtrl`	기본 생성자입니다.
`CMFCEditBrowseCtrl::~CMFCEditBrowseCtrl`	소멸자

공용 메서드

이름	설명
CMFCEditBrowseCtrl::EnableBrowseButton	찾아보기 단추를 사용하거나 사용하지 않도록 설정(숨깁니다).
CMFCEditBrowseCtrl::EnableFileBrowseButton	찾아보기 단추를 사용하도록 설정하고 편집 찾아보기 컨트롤을 파일 찾아보기 모드로 전환합니다.
CMFCEditBrowseCtrl::EnableFolderBrowseButton	찾아보기 단추를 사용하도록 설정하고 편집 찾아보기 컨트롤을 폴더 찾아보기 모드로 전환합니다.
CMFCEditBrowseCtrl::GetMode	현재 찾아보기 모드를 반환합니다.
CMFCEditBrowseCtrl::OnAfterUpdate	찾아보기 작업의 결과로 편집 찾아보기 컨트롤이 업데이트된 후 프레임워크에서 호출됩니다.
CMFCEditBrowseCtrl::OnBrowse	사용자가 찾아보기 단추를 클릭한 후 프레임워크에서 호출됩니다.
CMFCEditBrowseCtrl::OnChangeLayout	현재 편집 찾아보기 컨트롤을 다시 그립니다.
CMFCEditBrowseCtrl::OnDrawBrowseButton	찾아보기 단추를 그리기 위해 프레임워크에서 호출됩니다.
CMFCEditBrowseCtrl::OnIllegalFileName	편집 컨트롤에 잘못된 파일 이름이 입력되었을 때 프레임워크에서 호출됩니다.
`CMFCEditBrowseCtrl::PreTranslateMessage`	TranslateMessage 및 DispatchMessage Windows 함수로 디스패치되기 전에 창 메시지를 변환합니다. 구문 및 자세한 내용은 CWnd::P reTranslateMessage를 참조하세요.
CMFCEditBrowseCtrl::SetBrowseButtonImage	찾아보기 단추에 대한 사용자 지정 이미지를 설정합니다.

설명

편집 찾아보기 컨트롤을 사용하여 파일 또는 폴더 이름을 선택합니다. 필요에 따라 컨트롤을 사용하여 대화 상자를 표시하는 것과 같은 사용자 지정 작업을 수행합니다. 찾아보기 단추를 표시하거나 표시할 수 없으며 단추에 사용자 지정 레이블 또는 이미지를 적용할 수 있습니다.

찾아보기 편집 컨트롤의 찾아보기 모드는 찾아보기 단추를 표시할지 여부와 단추를 클릭할 때 발생하는 동작을 결정합니다. 자세한 내용은 GetMode 메서드를 참조하세요.

클래스는 CMFCEditBrowseCtrl 다음 모드를 지원합니다.

사용자 지정 모드

사용자가 찾아보기 단추를 클릭하면 사용자 지정 작업이 수행됩니다. 예를 들어 애플리케이션별 대화 상자를 표시할 수 있습니다.
파일 모드

사용자가 찾아보기 단추를 클릭하면 표준 파일 선택 대화 상자가 표시됩니다.
폴더 모드

사용자가 찾아보기 단추를 클릭하면 표준 폴더 선택 대화 상자가 표시됩니다.

방법: 찾아보기 컨트롤 편집 지정

애플리케이션에서 편집 찾아보기 컨트롤을 통합하려면 다음 단계를 수행합니다.

사용자 지정 찾아보기 모드를 구현하려면 클래스에서 CMFCEditBrowseCtrl 고유한 클래스를 파생한 다음 CMFCEditBrowseCtrl::OnBrowse 메서드를 재정의합니다. 재정의된 메서드에서 사용자 지정 찾아보기 작업을 실행하고 편집 찾아보기 컨트롤을 결과로 업데이트합니다.
개체 또는 파생된 편집 찾아보기 컨트롤 개체를 부모 창 개체에 포함 CMFCEditBrowseCtrl 합니다.
클래스 마법사를 사용하여 대화 상자를 만드는 경우 대화 상자 폼에 편집 컨트롤(CEdit)을 추가합니다. 또한 헤더 파일의 컨트롤에 액세스하는 변수를 추가합니다. 헤더 파일에서 변수의 형식을 .로 CEdit CMFCEditBrowseCtrl변경합니다. 편집 찾아보기 컨트롤이 자동으로 만들어집니다. 클래스 마법사를 사용하지 않는 경우 헤더 파일에 변수를 추가한 CMFCEditBrowseCtrl 다음 해당 메서드를 호출합니다Create.
편집 찾아보기 컨트롤을 대화 상자에 추가하는 경우 ClassWizard 도구를 사용하여 데이터 교환을 설정합니다.
EnableFolderBrowseButton, EnableFileBrowseButton 또는 EnableBrowseButton 메서드를 호출하여 찾아보기 모드를 설정하고 찾아보기 단추를 표시합니다. GetMode 메서드를 호출하여 현재 찾아보기 모드를 가져옵니다.
찾아보기 단추에 대한 사용자 지정 이미지를 제공하려면 SetBrowseButtonImage 메서드를 호출하거나 OnDrawBrowseButton 메서드를 재정의합니다.
찾아보기 편집 컨트롤에서 찾아보기 단추를 제거하려면 bEnable 매개 변수가 FALSE로 설정된 EnableBrowseButton 메서드를 호출합니다.

상속 계층 구조

예시

다음 예제에서는 클래스 EnableFolderBrowseButton 에서 CMFCEditBrowseCtrl 두 가지 메서드를 사용하는 방법을 보여 줍니다EnableFileBrowseButton. 이 예제는 새 컨트롤 샘플의 일부입니다.

CMFCEditBrowseCtrl m_wndFolderEdit;
CMFCEditBrowseCtrl m_wndFileEdit;

// enable the browse button and put the control in file browse mode
m_wndFolderEdit.EnableFolderBrowseButton();
// enable the browse button and put the control in the folder browse mode
m_wndFileEdit.EnableFileBrowseButton();

요구 사항

헤더: afxeditbrowsectrl.h

CMFCEditBrowseCtrl::EnableBrowseButton

현재 편집 찾아보기 컨트롤의 찾아보기 단추를 표시하거나 표시하지 않습니다.

void EnableBrowseButton(
    BOOL bEnable=TRUE,
    LPCTSTR szLabel=_T("..."));

매개 변수

bEnable
찾아보기 단추를 표시하려면 TRUE입니다. 찾아보기 단추를 표시하지 않는 FALSE입니다. 기본값은 TRUE입니다.

szLabel
찾아보기 단추에 표시되는 레이블입니다. 기본값은 " ..."입니다.

설명

bEnable 매개 변수가 TRUE이면 찾아보기 단추를 클릭할 때 수행할 사용자 지정 작업을 구현합니다. 사용자 지정 작업을 구현하려면 클래스에서 클래스를 CMFCEditBrowseCtrl 파생한 다음 OnBrowse 메서드를 재정의합니다.

bEnable 매개 변수가 TRUE이면 컨트롤의 찾아보기 모드가고BrowseMode_Default, 그렇지 않으면 찾아보기 모드가 됩니다BrowseMode_None. 찾아보기 모드에 대한 자세한 내용은 GetMode 메서드를 참조하세요.

CMFCEditBrowseCtrl::EnableFileBrowseButton

현재 편집 찾아보기 컨트롤에 찾아보기 단추를 표시하고 컨트롤을 파일 찾아보기 모드로 전환합니다.

void EnableFileBrowseButton(
    LPCTSTR lpszDefExt=NULL,
    LPCTSTR lpszFilter=NULL,
    DWORD dwFlags = OFN_HIDEREADONLY | OFN_OVERWRITEPROMPT);

매개 변수

lpszDefExt
파일 선택 대화 상자에서 사용되는 기본 파일 이름 확장명을 지정합니다. 기본값은 NULL입니다.

lpszFilter
파일 선택 대화 상자에서 사용되는 기본 필터 문자열을 지정합니다. 기본값은 NULL입니다.

dwFlags
대화 상자 플래그입니다. 기본값은 OFN_HIDEREADONLY와 OFN_OVERWRITEPROMPT의 비트 조합(OR)입니다.

설명

편집 찾아보기 컨트롤이 파일 찾아보기 모드에 있고 사용자가 찾아보기 단추를 클릭하는 경우 컨트롤이 표준 파일 선택 대화 상자를 표시합니다.

사용 가능한 플래그의 전체 목록은 OPENFILENAME 구조를 참조 하세요.

CMFCEditBrowseCtrl::EnableFolderBrowseButton

현재 편집 찾아보기 컨트롤의 찾아보기 단추를 표시하고 컨트롤을 폴더 찾아보기 모드로 전환합니다.

void EnableFolderBrowseButton();

설명

편집 찾아보기 컨트롤이 폴더 찾아보기 모드에 있고 사용자가 찾아보기 단추를 클릭하면 컨트롤에 표준 폴더 선택 대화 상자가 표시됩니다.

CMFCEditBrowseCtrl::GetMode

현재 편집 찾아보기 컨트롤의 찾아보기 모드를 검색합니다.

CMFCEditBrowseCtrl::BrowseMode GetMode() const;

Return Value

편집 찾아보기 컨트롤의 현재 모드를 지정하는 열거형 값 중 하나입니다. 찾아보기 모드는 프레임워크가 찾아보기 단추를 표시할지 여부와 사용자가 해당 단추를 클릭할 때 발생하는 작업을 결정합니다.

다음 표에서는 가능한 반환 값을 보여 줍니다.

값	설명
`BrowseMode_Default`	사용자 지정 모드입니다. 프로그래머 정의 작업이 수행됩니다.
`BrowseMode_File`	파일 모드입니다. 표준 파일 브라우저 대화 상자가 표시됩니다.
`BrowseMode_Folder`	폴더 모드입니다. 표준 폴더 브라우저 대화 상자가 표시됩니다.
`BrowseMode_None`	찾아보기 단추가 표시되지 않습니다.

설명

기본적으로 개체는 CMFCEditBrowseCtrl 모드로 BrowseMode_None 초기화됩니다. CMFCEditBrowseCtrl::EnableBrowseButton, CMFCEditBrowseCtrl::EnableFileBrowseButton 및 CMFCEditBrowseCtrl::EnableFolderBrowseButton 메서드를 사용하여 찾아보기 모드를 수정합니다.

CMFCEditBrowseCtrl::OnAfterUpdate

찾아보기 작업의 결과로 편집 찾아보기 컨트롤이 업데이트된 후 프레임워크에서 호출됩니다.

virtual void OnAfterUpdate();

설명

파생 클래스에서 이 메서드를 재정의하여 사용자 지정 작업을 구현합니다.

CMFCEditBrowseCtrl::OnBrowse

사용자가 찾아보기 컨트롤 편집의 찾아보기 단추를 클릭한 후 프레임워크에서 호출됩니다.

virtual void OnBrowse();

설명

사용자가 찾아보기 컨트롤 편집의 찾아보기 단추를 클릭할 때 이 메서드를 사용하여 사용자 지정 코드를 실행합니다. 클래스에서 고유한 클래스를 CMFCEditBrowseCtrl 파생하고 해당 메서드를 재정의합니다 OnBrowse . 이 메서드에서 사용자 지정 찾아보기 작업을 구현하고 선택적으로 편집 찾아보기 컨트롤의 텍스트 상자를 업데이트합니다. 애플리케이션에서 EnableBrowseButton 메서드를 사용하여 편집 찾아보기 컨트롤을 사용자 지정 찾아보기 모드로 전환합니다.

CMFCEditBrowseCtrl::OnChangeLayout

현재 편집 찾아보기 컨트롤을 다시 그립니다.

virtual void OnChangeLayout();

설명

편집 찾아보기 컨트롤의 찾아보기 모드가 변경되면 프레임워크에서 이 메서드를 호출합니다. 자세한 내용은 CMFCEditBrowseCtrl::GetMode를 참조하세요.

CMFCEditBrowseCtrl::OnDrawBrowseButton

편집 찾아보기 컨트롤에서 찾아보기 단추를 그리기 위해 프레임워크에서 호출됩니다.

virtual void OnDrawBrowseButton(
    CDC* pDC,
    CRect rect,
    BOOL bIsButtonPressed,
    BOOL bIsButtonHot);

매개 변수

pDC
디바이스 컨텍스트에 대한 포인터입니다.

사각형
찾아보기 단추의 경계 사각형입니다.

bIsButtonPressed
단추를 누르면 TRUE이고, 그렇지 않으면 FALSE입니다.

bIsButtonHot
단추가 강조 표시된 경우 TRUE입니다. 그렇지 않으면 FALSE입니다.

설명

파생 클래스에서 이 함수를 재정의하여 찾아보기 단추의 모양을 사용자 지정합니다.

CMFCEditBrowseCtrl::SetBrowseButtonImage

찾아보기 편집 컨트롤의 찾아보기 단추에 사용자 지정 이미지를 설정합니다.

void SetBrowseButtonImage(
    HICON hIcon,
    BOOL bAutoDestroy= TRUE);

void SetBrowseButtonImage(
    HBITMAP hBitmap,
    BOOL bAutoDestroy= TRUE);

void SetBrowseButtonImage(UINT uiBmpResId);

매개 변수

hIcon
아이콘의 핸들입니다.

hBitmap
비트맵의 핸들입니다.

uiBmpResId
비트맵의 리소스 ID입니다.

bAutoDestroy
TRUE이면 이 메서드가 종료될 때 지정된 아이콘 또는 비트맵을 삭제합니다. 그렇지 않으면 FALSE입니다. 기본값은 TRUE입니다.

설명

찾아보기 단추에 사용자 지정 이미지를 적용하려면 이 메서드를 사용합니다. 기본적으로 프레임워크는 편집 찾아보기 컨트롤이 파일 찾아보기 또는 폴더 찾아보기 모드에 있을 때 표준 이미지를 가져옵니다.

CMFCEditBrowseCtrl::OnIllegalFileName

편집 컨트롤에 잘못된 파일 이름이 입력되었을 때 프레임워크에서 호출됩니다.

virtual BOOL OnIllegalFileName(CString& strFileName);

매개 변수

strFileName
잘못된 파일 이름을 지정합니다.

Return Value

이 파일 이름을 파일 대화 상자에 더 이상 전달할 수 없는 경우 FALSE를 반환해야 합니다. 이 경우 포커스가 편집 컨트롤로 다시 설정되고 사용자는 계속 편집해야 합니다. 기본 구현은 잘못된 파일 이름에 대해 사용자에게 알리는 메시지 상자를 표시하고 FALSE를 반환합니다. 이 메서드를 재정의하고, 파일 이름을 수정하고, 추가 처리를 위해 TRUE를 반환할 수 있습니다.

설명

참고 항목

계층 구조 차트
클래스

다음을 통해 공유

CMFCEditBrowseCtrl 클래스

구문

멤버

공용 생성자

공용 메서드

설명

방법: 찾아보기 컨트롤 편집 지정

상속 계층 구조

예시

요구 사항

CMFCEditBrowseCtrl::EnableBrowseButton

매개 변수

설명

CMFCEditBrowseCtrl::EnableFileBrowseButton

매개 변수

설명

CMFCEditBrowseCtrl::EnableFolderBrowseButton

설명

CMFCEditBrowseCtrl::GetMode

Return Value

설명

CMFCEditBrowseCtrl::OnAfterUpdate

설명

CMFCEditBrowseCtrl::OnBrowse

설명

CMFCEditBrowseCtrl::OnChangeLayout

설명

CMFCEditBrowseCtrl::OnDrawBrowseButton

매개 변수

설명

CMFCEditBrowseCtrl::SetBrowseButtonImage

매개 변수

설명

CMFCEditBrowseCtrl::OnIllegalFileName

매개 변수

Return Value

설명

참고 항목

피드백

추가 리소스