다음을 통해 공유


COleConvertDialog 클래스

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

구문

class COleConvertDialog : public COleDialog

멤버

공용 생성자

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

공용 메서드

이름 설명
COleConvertDialog::D oConvert 대화 상자에 지정된 변환을 수행합니다.
COleConvertDialog::D oModal OLE 항목 변경 대화 상자를 표시합니다.
COleConvertDialog::GetClassID 선택한 항목과 연결된 CLSID를 가져옵니다.
COleConvertDialog::GetDrawAspect 항목을 아이콘으로 그릴지 여부를 지정합니다.
COleConvertDialog::GetIconicMetafile 이 항목의 아이콘 형식과 연결된 메타파일의 핸들을 가져옵니다.
COleConvertDialog::GetSelectionType 선택한 선택 유형을 가져옵니다.

공용 데이터 멤버

이름 설명
COleConvertDialog::m_cv 대화 상자의 동작을 제어하는 구조체입니다.

설명

참고 항목

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

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

상속 계층 구조

CObject

CCmdTarget

CWnd

Cdialog

CCommonDialog

COleDialog

COleConvertDialog

요구 사항

헤더: afxodlgs.h

COleConvertDialog::COleConvertDialog

개체만 COleConvertDialog 생성합니다.

explicit COleConvertDialog (
    COleClientItem* pItem,
    DWORD dwFlags = CF_SELECTCONVERTTO,
    CLSID* pClassID = NULL,
    CWnd* pParentWnd = NULL);

매개 변수

pItem
변환하거나 활성화할 항목을 가리킵니다.

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

  • CF_SELECTCONVERTTO 대화 상자가 호출될 때 라디오로 변환 단추가 처음에 선택되도록 지정합니다. 기본값입니다.

  • CF_SELECTACTIVATEAS 대화 상자가 호출될 때 처음에 활성화 라디오 단추가 선택되도록 지정합니다.

  • CF_SETCONVERTDEFAULT 구조체의 m_cv 멤버가 clsidConvertDefault CLSID를 지정한 클래스가 라디오로 변환 단추를 선택할 때 클래스 목록 상자에서 기본 선택 영역으로 사용되도록 지정합니다.

  • CF_SETACTIVATEDEFAULT 구조체의 m_cv 멤버가 clsidActivateDefault CLSID를 지정한 클래스가 라디오로 활성화 단추를 선택할 때 클래스 목록 상자에서 기본 선택 영역으로 사용되도록 지정합니다.

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

pClassID
변환하거나 활성화할 항목의 CLSID를 가리킵니다. NULL이면 pItem연결된 CLSID가 사용됩니다.

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

설명

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

자세한 내용은 CLSID 키OLEUICONVERT 구조를 참조하세요.

COleConvertDialog::D oConvert

DoModal에서 성공적으로 반환된 후 COleClientItem 형식의 개체를 변환하거나 활성화하려면 이 함수를 호출합니다.

BOOL DoConvert(COleClientItem* pItem);

매개 변수

pItem
변환하거나 활성화할 항목을 가리킵니다. NULL일 수 없습니다.

Return Value

성공하면 0이 아니고, 그렇지 않으면 0입니다.

설명

변환 대화 상자에서 사용자가 선택한 정보에 따라 항목이 변환되거나 활성화됩니다.

COleConvertDialog::D oModal

OLE 변환 대화 상자를 표시하려면 이 함수를 호출합니다.

virtual INT_PTR DoModal();

Return Value

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

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

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

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

설명

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

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

COleConvertDialog::GetClassID

변환 대화 상자에서 사용자가 선택한 항목과 연결된 CLSID를 얻으려면 이 함수를 호출합니다.

REFCLSID GetClassID() const;

Return Value

변환 대화 상자에서 선택한 항목과 연결된 CLSID입니다.

설명

DoModal이 IDOK를 반환한 후에만 이 함수를 호출합니다.

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

COleConvertDialog::GetDrawAspect

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

DVASPECT GetDrawAspect() const;

Return Value

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

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

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

설명

DoModal이 IDOK를 반환한 후에만 이 함수를 호출합니다.

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

COleConvertDialog::GetIconicMetafile

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

HGLOBAL GetIconicMetafile() const;

Return Value

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

COleConvertDialog::GetSelectionType

변환 대화 상자에서 선택한 변환 유형을 확인하려면 이 함수를 호출합니다.

UINT GetSelectionType() const;

Return Value

선택한 형식입니다.

설명

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

enum Selection {
    noConversion,
    convertItem,
    activateAs
    };

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

  • COleConvertDialog::noConversion 대화 상자가 취소되었거나 사용자가 변환을 선택하지 않은 경우 반환됩니다. IDOK를 반환하는 경우 COleConvertDialog::DoModal 사용자가 이전에 선택한 아이콘과 다른 아이콘을 선택했을 수 있습니다.

  • COleConvertDialog::convertItem라디오로 변환 단추가 검사 경우 반환된 사용자는 변환할 다른 항목을 선택하고 IDOK를 DoModal 반환했습니다.

  • COleConvertDialog::activateAs활성화 라디오 단추가 검사 경우 반환된 사용자는 활성화 DoModal 할 다른 항목을 선택하고 IDOK를 반환했습니다.

COleConvertDialog::m_cv

변환 대화 상자의 동작을 제어하는 데 사용되는 OLEUICONVERT 형식의 구조입니다.

OLEUICONVERT m_cv;

설명

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

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

참고 항목

COleDialog 클래스
계층 구조 차트
COleDialog 클래스