다음을 통해 공유

COleInsertDialog 클래스

  • 아티클

OLE 개체 삽입 대화 상자에 사용합니다.

구문

class COleInsertDialog : public COleDialog

멤버

공용 생성자

속성 설명
COleInsertDialog::COleInsertDialog COleInsertDialog 개체를 생성합니다.

공용 메서드

이름 설명
COleInsertDialog::CreateItem 대화 상자에서 선택한 항목을 만듭니다.
COleInsertDialog::DoModal OLE 개체 삽입 대화 상자를 표시합니다.
COleInsertDialog::GetClassID 선택한 항목과 연결된 CLSID를 가져옵니다.
COleInsertDialog::GetDrawAspect 항목을 아이콘으로 그릴지 여부를 알려줍니다.
COleInsertDialog::GetIconicMetafile 이 항목의 아이콘 형식과 연결된 메타파일의 핸들을 가져옵니다.
COleInsertDialog::GetPathName 대화 상자에서 선택한 파일의 전체 경로를 가져옵니다.
COleInsertDialog::GetSelectionType 선택한 개체의 형식을 가져옵니다.

공용 데이터 멤버

이름 설명
COleInsertDialog::m_io 대화 상자의 동작을 제어하는 OLEUIINSERTOBJECT 형식의 구조체입니다.

설명

이 대화 상자를 호출하려는 경우 클래스 COleInsertDialog 의 개체를 만듭니다. COleInsertDialog 개체를 생성한 후에는 m_io 구조를 사용하여 대화 상자에서 컨트롤의 값 또는 상태를 초기화할 수 있습니다. 구조체 m_io 는 OLEUIINSERTOBJECT 형식입니다. 이 대화 상자 클래스를 사용하는 방법에 대한 자세한 내용은 DoModal 멤버 함수를 참조하세요.

참고 항목

애플리케이션 마법사에서 생성된 컨테이너 코드는 이 클래스를 사용합니다.

자세한 내용은 Windows SDK의 OLEUIINSERTOBJECT 구조를 참조하세요.

OLE 관련 대화 상자에 대한 자세한 내용은 OLE의 문서 대화 상자를 참조하세요.

상속 계층 구조

CObject

CCmdTarget

CWnd

Cdialog

CCommonDialog

COleDialog

COleInsertDialog

요구 사항

헤더: afxodlgs.h

COleInsertDialog::COleInsertDialog

이 함수는 개체만 COleInsertDialog 생성합니다.

COleInsertDialog (
    DWORD dwFlags = IOF_SELECTCREATENEW,
    CWnd* pParentWnd = NULL);

매개 변수

dwFlags
비트 OR 연산자를 사용하여 결합할 다음 값의 개수를 포함하는 생성 플래그입니다.

  • IOF_SHOWHELP 대화 상자가 호출될 때 도움말 단추가 표시되도록 지정합니다.

  • IOF_SELECTCREATENEW 대화 상자가 호출될 때 새 라디오 만들기 단추가 처음에 선택되도록 지정합니다. 기본값이며 IOF_SELECTCREATEFROMFILE 사용할 수 없습니다.

  • IOF_SELECTCREATEFROMFILE 대화 상자가 호출될 때 파일에서 만들기 라디오 단추가 처음에 선택되도록 지정합니다. IOF_SELECTCREATENEW 사용할 수 없습니다.

  • IOF_CHECKLINK 대화 상자가 호출될 때 처음에 링크 검사 상자가 검사 지정합니다.

  • IOF_DISABLELINK 대화 상자가 호출될 때 링크 검사 상자를 사용하지 않도록 지정합니다.

  • IOF_CHECKDISPLAYASICON 처음에 아이콘으로 표시 검사 상자가 검사 현재 아이콘이 표시되고 대화 상자가 호출될 때 변경 아이콘 단추가 사용하도록 지정합니다.

  • IOF_VERIFYSERVERSEXIST 대화 상자가 표시되기 전에 등록 데이터베이스에 지정된 서버가 있는지 확인하여 대화 상자가 목록 상자에 추가하는 클래스의 유효성을 검사하도록 지정합니다. 이 플래그를 설정하면 성능이 크게 저하될 수 있습니다.

pParentWnd
대화 상자 개체가 속한 부모 또는 소유자 창 개체(형식 CWnd)를 가리킵니다. NULL이면 대화 상자 개체의 부모 창이 기본 애플리케이션 창으로 설정됩니다.

설명

대화 상자를 표시하려면 DoModal 함수를 호출합니다.

COleInsertDialog::CreateItem

DoModal이 IDOK를 반환하는 경우에만 COleClientItem 형식의 개체를 만들려면 이 함수를 호출합니다.

BOOL CreateItem(COleClientItem* pItem);

매개 변수

pItem
만들 항목을 가리킵니다.

Return Value

항목이 만들어진 경우 0이 아닌 경우 그렇지 않으면 0입니다.

설명

이 함수를 COleClientItem 호출하려면 먼저 개체를 할당해야 합니다.

COleInsertDialog::DoModal

이 함수를 호출하여 OLE 개체 삽입 대화 상자를 표시합니다.

virtual INT_PTR
    DoModal();

INT_PTR
    DoModal(DWORD  dwFlags);

매개 변수

dwFlags
다음 값 중 하나:

COleInsertDialog::DocObjectsOnly 는 DocObjects만 삽입합니다.

COleInsertDialog::ControlsOnly 는 ActiveX 컨트롤만 삽입합니다.

0은 DocObject 또는 ActiveX 컨트롤을 삽입하지 않습니다. 이 값은 위에 나열된 첫 번째 프로토타입과 동일한 구현을 생성합니다.

Return Value

대화 상자의 완료 상태. 다음 값 중 하나:

  • 대화 상자가 성공적으로 표시되면 IDOK입니다.

  • 사용자가 대화 상자를 취소한 경우 IDCANCEL입니다.

  • 오류가 발생한 경우 IDABORT입니다. IDABORT가 반환되면 COleDialog::GetLastError 멤버 함수를 호출하여 발생한 오류 유형에 대한 자세한 정보를 가져옵니다. 가능한 오류 목록은 Windows SDK의 OleUIInsertObject 함수를 참조하세요.

설명

m_io 구조체의 멤버를 설정하여 다양한 대화 상자 컨트롤을 초기화하려면 호출DoModal하기 전에 이 작업을 수행해야 하지만 대화 상자 개체가 생성된 후에는 이 작업을 수행해야 합니다.

IDOK를 반환하는 경우 DoModal 다른 멤버 함수를 호출하여 사용자가 대화 상자에 대한 설정 또는 정보 입력을 검색할 수 있습니다.

COleInsertDialog::GetClassID

DoModal이 IDOK를 반환하고 선택 유형COleInsertDialog::createNewItem이 있는 경우에만 선택한 항목과 연결된 CLSID를 가져오려면 이 함수를 호출합니다.

REFCLSID GetClassID() const;

Return Value

선택한 항목과 연결된 CLSID를 반환합니다.

설명

자세한 내용은 Windows SDK의 CLSID 키를 참조하세요.

COleInsertDialog::GetDrawAspect

이 함수를 호출하여 사용자가 선택한 항목을 아이콘으로 표시하도록 선택했는지 확인합니다.

DVASPECT GetDrawAspect() const;

Return Value

개체를 렌더링하는 데 필요한 메서드입니다.

  • DVASPECT_CONTENT 아이콘으로 표시 검사 상자가 검사 않은 경우 반환됩니다.

  • 아이콘으로 표시 검사 상자가 검사 경우 DVASPECT_ICON 반환됩니다.

설명

DoModal이 IDOK를 반환하는 경우에만 이 함수를 호출합니다.

그리기 측면에 대한 자세한 내용은 Windows SDK의 FORMATETC 데이터 구조를 참조하세요.

COleInsertDialog::GetIconicMetafile

이 함수를 호출하여 선택한 항목의 상징적인 측면이 포함된 메타파일 핸들을 가져옵니다.

HGLOBAL GetIconicMetafile() const;

Return Value

선택한 항목의 상징적인 측면이 포함된 메타파일 핸들입니다. 확인(OK)을 선택하여 대화 상자를 해제할 때 아이콘으로 표시 검사 상자가 검사 경우, 그렇지 않으면 NULL입니다.

COleInsertDialog::GetPathName

DoModal이 IDOK를 반환하고 선택 유형이 아닌 COleInsertDialog::createNewItem경우에만 선택한 파일의 전체 경로를 가져오려면 이 함수를 호출합니다.

CString GetPathName() const;

Return Value

대화 상자에서 선택한 파일의 전체 경로입니다. 선택 유형이면 이 함수는 createNewItem릴리스 모드에서 의미 없는 CString 값을 반환하거나 디버그 모드에서 어설션을 발생합니다.

COleInsertDialog::GetSelectionType

[확인]을 선택하여 개체 삽입 대화 상자를 해제할 때 선택한 선택 유형을 얻으려면 이 함수를 호출합니다.

UINT GetSelectionType() const;

Return Value

선택한 형식입니다.

설명

반환 형식 값은 클래스에 Selection 선언된 열거형 형식으로 COleInsertDialog 지정됩니다.

enum Selection {
    createNewItem,
    insertFromFile,
    linkToFile
    };

이러한 값에 대한 간략한 설명은 다음과 같습니다.

  • COleInsertDialog::createNewItem 새로 만들기 라디오 단추가 선택되었습니다.

  • COleInsertDialog::insertFromFile파일에서 만들기 라디오 단추가 선택되었고 링크 검사 상자가 검사 않았습니다.

  • COleInsertDialog::linkToFile파일에서 만들기 라디오 단추가 선택되었고 링크 검사 상자가 검사.

COleInsertDialog::m_io

개체 삽입 대화 상자의 동작을 제어하는 데 사용되는 OLEUIINSERTOBJECT 형식의 구조체입니다.

OLEUIINSERTOBJECT m_io;

설명

이 구조체의 멤버는 직접 또는 멤버 함수를 통해 수정할 수 있습니다.

자세한 내용은 Windows SDK의 OLEUIINSERTOBJECT 구조를 참조하세요.

참고 항목

MFC 샘플 OCLIENT
COleDialog 클래스
계층 구조 차트
COleDialog 클래스