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의 문서 대화 상자를 참조하세요.
상속 계층 구조
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
[확인]을 선택하여 대화 상자를 해제할 때 아이콘으로 표시 확인란을 선택한 경우 선택한 항목의 아이콘 측면을 포함하는 메타파일의 핸들입니다. 그렇지 않으면 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 구조를 참조하세요.