다음을 통해 공유


COleChangeIconDialog 클래스

OLE 아이콘 변경 대화 상자에 사용합니다.

구문

class COleChangeIconDialog : public COleDialog

멤버

공용 생성자

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

공용 메서드

이름 설명
COleChangeIconDialog::DoChangeIcon 대화 상자에 지정된 변경 작업을 수행합니다.
COleChangeIconDialog::DoModal OLE 2 변경 아이콘 대화 상자를 표시합니다.
COleChangeIconDialog::GetIconicMetafile 이 항목의 아이콘 형식과 연결된 메타파일의 핸들을 가져옵니다.

공용 데이터 멤버

속성 설명
COleChangeIconDialog::m_ci 대화 상자의 동작을 제어하는 구조체입니다.

설명

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

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

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

상속 계층 구조

CObject

CCmdTarget

CWnd

CDialog

CCommonDialog

COleDialog

COleChangeIconDialog

요구 사항

헤더: afxodlgs.h

COleChangeIconDialog::COleChangeIconDialog

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

explicit COleChangeIconDialog(
    COleClientItem* pItem,
    DWORD dwFlags = CIF_SELECTCURRENT,
    CWnd* pParentWnd = NULL);

매개 변수

pItem
변환할 항목을 가리킵니다.

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

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

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

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

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

  • CIF_USEICONEXE 형식에서 검색하는 대신 m_ci 필드에 지정된 szIconExe 실행 파일에서 아이콘을 추출해야 되도록 지정합니다. 이는 OLE가 아닌 파일을 포함하거나 연결하는 데 유용합니다.

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

설명

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

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

COleChangeIconDialog::DoChangeIcon

DoModal이 IDOK를 반환한 후 항목을 나타내는 아이콘을 대화 상자에서 선택한 아이콘으로 변경하려면 이 함수를 호출합니다.

BOOL DoChangeIcon(COleClientItem* pItem);

매개 변수

pItem
아이콘이 변경되는 항목을 가리킵니다.

Return Value

변경에 성공하면 0이 아닌 경우 그렇지 않으면 0입니다.

COleChangeIconDialog::DoModal

이 함수를 호출하여 OLE 변경 아이콘 대화 상자를 표시합니다.

virtual INT_PTR DoModal();

Return Value

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

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

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

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

설명

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

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

COleChangeIconDialog::GetIconicMetafile

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

HGLOBAL GetIconicMetafile() const;

Return Value

[확인]을 선택하여 대화 상자를 해제한 경우 새 아이콘의 아이콘 측면을 포함하는 메타파일 핸들입니다. 그렇지 않으면 대화 상자가 표시되기 전의 아이콘입니다.

COleChangeIconDialog::m_ci

아이콘 변경 대화 상자의 동작을 제어하는 데 사용되는 OLEUICHANGEICON 형식의 구조입니다.

OLEUICHANGEICON m_ci;

설명

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

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

참고 항목

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