COlePasteSpecialDialog 클래스

아티클
08/04/2024

OLE 선택하여 붙여넣기 대화 상자에 사용합니다.

구문

class COlePasteSpecialDialog : public COleDialog

멤버

공용 생성자

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

공용 메서드

이름	설명
COlePasteSpecialDialog::AddFormat	애플리케이션에서 붙여 넣을 수 있는 형식 목록에 사용자 지정 형식을 추가합니다.
COlePasteSpecialDialog::AddLinkEntry	지원되는 클립보드 형식 목록에 새 항목을 추가합니다.
COlePasteSpecialDialog::AddStandardFormats	애플리케이션에서 붙여넣을 수 있는 형식 목록에 CF_BITMAP, CF_DIB, CF_METAFILEPICT 및 선택적으로 CF_LINKSOURCE 추가합니다.
COlePasteSpecialDialog::CreateItem	지정된 형식을 사용하여 컨테이너 문서에 항목을 만듭니다.
COlePasteSpecialDialog::D oModal	OLE 붙여넣기 특수 대화 상자를 표시합니다.
COlePasteSpecialDialog::GetDrawAspect	항목을 아이콘으로 그릴지 여부를 알려줍니다.
COlePasteSpecialDialog::GetIconicMetafile	이 항목의 아이콘 형식과 연결된 메타파일의 핸들을 가져옵니다.
COlePasteSpecialDialog::GetPasteIndex	사용자가 선택한 사용 가능한 붙여넣기 옵션의 인덱스입니다.
COlePasteSpecialDialog::GetSelectionType	선택한 선택 유형을 가져옵니다.

공용 데이터 멤버

속성	설명
COlePasteSpecialDialog::m_ps	대화 상자의 함수를 제어하는 OLEUIPASTESPECIAL 형식의 구조체입니다.

설명

이 대화 상자를 호출하려는 경우 클래스 COlePasteSpecialDialog 의 개체를 만듭니다. 개체가 COlePasteSpecialDialog 생성된 후 AddFormat 및 AddStandardFormats 멤버 함수를 사용하여 대화 상자에 클립보드 형식을 추가할 수 있습니다. m_ps 구조를 사용하여 대화 상자에서 컨트롤의 값 또는 상태를 초기화할 수도 있습니다. 구조체 m_ps 는 OLEUIPASTESPECIAL 형식입니다.

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

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

상속 계층 구조

COlePasteSpecialDialog

요구 사항

헤더: afxodlgs.h

COlePasteSpecialDialog::AddFormat

이 함수를 호출하여 특수 붙여넣기 작업에서 애플리케이션에서 지원할 수 있는 형식 목록에 새 형식을 추가합니다.

void AddFormat(
    const FORMATETC& formatEtc,
    LPTSTR lpszFormat,
    LPTSTR lpszResult,
    DWORD flags);

void AddFormat(
    UINT cf,
    DWORD tymed,
    UINT nFormatID,
    BOOL bEnableIcon,
    BOOL bLink);

매개 변수

fmt
추가할 데이터 형식에 대한 참조입니다.

lpszFormat
사용자에게 형식을 설명하는 문자열입니다.

lpszResult
대화 상자에서 이 형식을 선택한 경우 결과를 설명하는 문자열입니다.

flags
이 형식에 사용할 수 있는 다양한 연결 및 포함 옵션입니다. 이 플래그는 OLEUIPASTEFLAG 열거형 형식의 서로 다른 값 중 하나 이상의 비트 조합입니다.

cf
추가할 클립보드 형식입니다.

tymed
이 형식으로 사용할 수 있는 미디어 유형입니다. TYMED 열거형 형식의 값 중 하나 이상의 비트 조합입니다.

nFormatID
이 형식을 식별하는 문자열의 ID입니다. 이 문자열의 형식은 '\n' 문자로 구분된 두 개의 개별 문자열입니다. 첫 번째 문자열은 lpstrFormat 매개 변수에 전달되는 문자열과 같고 두 번째 문자열은 lpstrResult 매개 변수와 동일합니다.

bEnableIcon
목록 상자에서 이 형식을 선택할 때 아이콘으로 표시 확인란을 사용할 수 있는지 여부를 결정하는 플래그입니다.

눈을 깜박거리다
목록 상자에서 이 형식을 선택할 때 링크 붙여넣기 라디오 단추를 사용할 수 있는지 여부를 결정하는 플래그입니다.

설명

이 함수를 호출하여 애플리케이션이 시스템에 등록한 CF_TEXT 또는 CF_TIFF 또는 사용자 지정 형식과 같은 표준 형식을 추가할 수 있습니다. 애플리케이션에 데이터 개체를 붙여넣는 방법에 대한 자세한 내용은 데이터 개체 및 데이터 원본: 조작 문서를 참조하세요.

자세한 내용은 Windows SDK의 TYMED 열거형 형식 및 FORMATETC 구조를 참조하세요.

자세한 내용은 Windows SDK의 OLEUIPASTEFLAG 열거형 형식을 참조하세요.

COlePasteSpecialDialog::AddLinkEntry

지원되는 클립보드 형식 목록에 새 항목을 추가합니다.

OLEUIPASTEFLAG AddLinkEntry(UINT cf);

매개 변수

cf
추가할 클립보드 형식입니다.

Return Value

새 링크 항목에 대한 정보를 포함하는 OLEUIPASTEFLAG 구조체입니다.

COlePasteSpecialDialog::AddStandardFormats

이 함수를 호출하여 특수 붙여넣기 작업에서 애플리케이션에서 지원할 수 있는 형식 목록에 다음 클립보드 형식을 추가합니다.

void AddStandardFormats(BOOL bEnableLink = TRUE);

매개 변수

bEnableLink
애플리케이션에서 붙여넣을 수 있는 형식 목록에 CF_LINKSOURCE 추가할지 여부를 결정하는 플래그입니다.

설명

CF_BITMAP
CF_DIB
CF_METAFILEPICT
"Embedded 개체"
(선택 사항) " 링크 원본"

이러한 형식은 포함 및 연결을 지원하는 데 사용됩니다.

COlePasteSpecialDialog::COlePasteSpecialDialog

COlePasteSpecialDialog 개체를 생성합니다.

COlePasteSpecialDialog(
    DWORD dwFlags = PSF_SELECTPASTE,
    COleDataObject* pDataObject = NULL,
    CWnd* pParentWnd = NULL);

매개 변수

dwFlags
만들기 플래그는 비트 OR 연산자를 사용하여 결합된 다음 플래그의 수를 포함합니다.

PSF_SELECTPASTE 대화 상자가 호출될 때 라디오 붙여넣기 단추가 처음에 선택되도록 지정합니다. PSF_SELECTPASTELINK 함께 사용할 수 없습니다. 기본값입니다.
PSF_SELECTPASTELINK 대화 상자가 호출될 때 처음에 링크 붙여넣기 라디오 단추가 선택되도록 지정합니다. PSF_SELECTPASTE 함께 사용할 수 없습니다.
PSF_CHECKDISPLAYASICON 대화 상자가 호출될 때 아이콘으로 표시 확인란이 처음에 선택되도록 지정합니다.
PSF_SHOWHELP 대화 상자가 호출될 때 도움말 단추가 표시되도록 지정합니다.

pDataObject
붙여넣기 용 COleDataObject 를 가리킵니다. 이 값이 NULL이면 클립보드에서 가져옵니다 COleDataObject .

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

설명

이 함수는 개체만 생성합니다 COlePasteSpecialDialog . 대화 상자를 표시하려면 DoModal 함수를 호출합니다.

자세한 내용은 Windows SDK의 OLEUIPASTEFLAG 열거형 형식을 참조하세요.

COlePasteSpecialDialog::CreateItem

선택하여 붙여넣기 대화 상자에서 선택한 새 항목을 만듭니다.

BOOL CreateItem(COleClientItem* pNewItem);

매개 변수

pNewItem
인스턴스를 가리킵니다 COleClientItem . NULL일 수 없습니다.

Return Value

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

설명

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

COlePasteSpecialDialog::D oModal

OLE 붙여넣기 특수 대화 상자를 표시합니다.

virtual INT_PTR DoModal();

Return Value

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

대화 상자가 성공적으로 표시되면 IDOK입니다.
사용자가 대화 상자를 취소한 경우 IDCANCEL입니다.
오류가 발생한 경우 IDABORT입니다. IDABORT가 반환되면 멤버 함수를 COleDialog::GetLastError 호출하여 발생한 오류 유형에 대한 자세한 정보를 가져옵니다. 가능한 오류 목록은 Windows SDK의 OleUIPasteSpecial 함수를 참조하세요.

설명

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

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

COlePasteSpecialDialog::GetDrawAspect

사용자가 선택한 항목을 아이콘으로 표시하도록 선택했는지 여부를 결정합니다.

DVASPECT GetDrawAspect() const;

Return Value

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

DVASPECT_CONTENT 대화 상자가 해제되었을 때 아이콘으로 표시 확인란을 선택하지 않은 경우 반환됩니다.
DVASPECT_ICON 대화 상자가 해제되었을 때 아이콘으로 표시 확인란이 선택되어 있으면 반환됩니다.

설명

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

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

COlePasteSpecialDialog::GetIconicMetafile

사용자가 선택한 항목과 연결된 메타파일을 가져옵니다.

HGLOBAL GetIconicMetafile() const;

Return Value

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

COlePasteSpecialDialog::GetPasteIndex

사용자가 선택한 항목과 연결된 인덱스 값을 가져옵니다.

int GetPasteIndex() const;

Return Value

사용자가 선택한 구조체 배열의 OLEUIPASTEENTRY 인덱스입니다. 붙여넣기 작업을 수행할 때 선택한 인덱스에 해당하는 형식을 사용해야 합니다.

설명

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

COlePasteSpecialDialog::GetSelectionType

사용자가 선택한 유형을 결정합니다.

UINT GetSelectionType() const;

Return Value

선택한 형식을 반환합니다.

설명

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

enum Selection {
    pasteLink,
    pasteNormal,
    pasteOther,
    pasteStatic
    };

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

COlePasteSpecialDialog::pasteLink 링크 붙여넣기 라디오 단추가 선택되었고 선택한 형식이 표준 OLE 형식이었습니다.
COlePasteSpecialDialog::pasteNormal 라디오 붙여넣기 단추가 선택되었고 선택한 형식이 표준 OLE 형식이었습니다.
COlePasteSpecialDialog::pasteOther 선택한 형식이 표준 OLE 형식이 아닙니다.
COlePasteSpecialDialog::pasteStatic 선택한 형식은 메타파일이었습니다.

COlePasteSpecialDialog::m_ps

특수 붙여넣기 대화 상자의 동작을 제어하는 데 사용되는 OLEUIPASTESPECIAL 형식의 구조입니다.

OLEUIPASTESPECIAL m_ps;

설명

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

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

참고 항목

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

다음을 통해 공유

COlePasteSpecialDialog 클래스

구문

멤버

공용 생성자

공용 메서드

공용 데이터 멤버

설명

상속 계층 구조

요구 사항

COlePasteSpecialDialog::AddFormat

매개 변수

설명

COlePasteSpecialDialog::AddLinkEntry

매개 변수

Return Value

COlePasteSpecialDialog::AddStandardFormats

매개 변수

설명

COlePasteSpecialDialog::COlePasteSpecialDialog

매개 변수

설명

COlePasteSpecialDialog::CreateItem

매개 변수

Return Value

설명

COlePasteSpecialDialog::D oModal

Return Value

설명

COlePasteSpecialDialog::GetDrawAspect

Return Value

설명

COlePasteSpecialDialog::GetIconicMetafile

Return Value

COlePasteSpecialDialog::GetPasteIndex

Return Value

설명

COlePasteSpecialDialog::GetSelectionType

Return Value

설명

COlePasteSpecialDialog::m_ps

설명

참고 항목

피드백

추가 리소스