다음을 통해 공유

COleChangeSourceDialog 클래스

  • 아티클

OLE 소스 변경 대화 상자에 사용합니다.

구문

class COleChangeSourceDialog : public COleDialog

멤버

공용 생성자

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

공용 메서드

이름 설명
COleChangeSourceDialog::DoModal OLE 원본 변경 대화 상자를 표시합니다.
COleChangeSourceDialog::GetDisplayName 전체 원본 표시 이름을 가져옵니다.
COleChangeSourceDialog::GetFileName 원본 이름에서 파일 이름을 가져옵니다.
COleChangeSourceDialog::GetFromPrefix 이전 원본의 접두사를 가져옵니다.
COleChangeSourceDialog::GetItemName 원본 이름에서 항목 이름을 가져옵니다.
COleChangeSourceDialog::GetToPrefix 새 원본의 접두사를 가져옵니다.
COleChangeSourceDialog::IsValidSource 원본이 유효한지 나타냅니다.

공용 데이터 멤버

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

설명

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

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

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

상속 계층 구조

CObject

CCmdTarget

CWnd

Cdialog

CCommonDialog

COleDialog

COleChangeSourceDialog

요구 사항

헤더: afxodlgs.h

COleChangeSourceDialog::COleChangeSourceDialog

이 함수는 개체를 COleChangeSourceDialog 생성합니다.

explicit COleChangeSourceDialog(
    COleClientItem* pItem,
    CWnd* pParentWnd = NULL);

매개 변수

pItem
원본을 업데이트할 연결된 COleClientItem 에 대한 포인터입니다.

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

설명

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

자세한 내용은 Windows SDK의 OLEUICHANGESOURCE 구조 및 OleUIChangeSource 함수를 참조하세요.

COleChangeSourceDialog::DoModal

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

virtual INT_PTR DoModal();

Return Value

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

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

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

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

설명

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

IDOK를 반환하는 경우 DoModal 멤버 함수를 호출하여 대화 상자에서 사용자가 입력한 설정 또는 정보를 검색할 수 있습니다. 다음 목록은 일반적인 쿼리 함수의 이름을 지정합니다.

COleChangeSourceDialog::GetDisplayName

연결된 클라이언트 항목의 전체 표시 이름을 검색하려면 이 함수를 호출합니다.

CString GetDisplayName();

Return Value

생성자에 지정된 COleClientItem의 전체 소스 표시 이름(모니커)입니다.

COleChangeSourceDialog::GetFileName

연결된 클라이언트 항목에 대한 표시 이름의 파일 모니커 부분을 검색하려면 이 함수를 호출합니다.

CString GetFileName();

Return Value

생성자에 지정된 COleClientItem에 대한 원본 표시 이름의 파일 모니커 부분입니다.

설명

파일 모니커와 항목 모니커를 함께 사용하면 전체 표시 이름이 지정됩니다.

COleChangeSourceDialog::GetFromPrefix

이 함수를 호출하여 원본에 대한 이전 접두사 문자열을 가져옵니다.

CString GetFromPrefix();

Return Value

원본의 이전 접두사 문자열입니다.

설명

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

이 값은 OLEUICHANGESOURCE 구조체의 멤버에서 lpszFrom 직접 가져옵니다.

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

COleChangeSourceDialog::GetItemName

연결된 클라이언트 항목에 대한 표시 이름의 항목 모니커 부분을 검색하려면 이 함수를 호출합니다.

CString GetItemName();

Return Value

생성자에 지정된 COleClientItem에 대한 원본 표시 이름의 항목 모니커 부분입니다.

설명

파일 모니커와 항목 모니커를 함께 사용하면 전체 표시 이름이 지정됩니다.

COleChangeSourceDialog::GetToPrefix

이 함수를 호출하여 원본에 대한 새 접두사 문자열을 가져옵니다.

CString GetToPrefix();

Return Value

원본의 새 접두사 문자열입니다.

설명

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

이 값은 OLEUICHANGESOURCE 구조체의 멤버에서 lpszTo 직접 가져옵니다.

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

COleChangeSourceDialog::m_cs

이 데이터 멤버는 OLEUICHANGESOURCE 형식의 구조체입니다.

OLEUICHANGESOURCE m_cs;

설명

OLEUICHANGESOURCE 는 OLE 원본 변경 대화 상자의 동작을 제어하는 데 사용됩니다. 이 구조체의 멤버는 직접 수정할 수 있습니다.

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

COleChangeSourceDialog::IsValidSource

이 함수를 호출하여 새 원본이 유효한지 확인합니다.

BOOL IsValidSource();

Return Value

새 원본이 유효하면 0이 아니고, 그렇지 않으면 0입니다.

설명

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

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

참고 항목

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