다음을 통해 공유

CDataPathProperty 클래스

  • 아티클

비동기적으로 로드할 수 있는 OLE 컨트롤 속성을 구현합니다.

구문

class CDataPathProperty : public CAsyncMonikerFile

멤버

공용 생성자

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

공용 메서드

이름 설명
CDataPathProperty::GetControl 개체와 연결된 비동기 OLE 컨트롤을 CDataPathProperty 검색합니다.
CDataPathProperty::GetPath 속성의 경로 이름을 검색합니다.
CDataPathProperty::Open 연결된 OLE(ActiveX) 컨트롤에 대한 비동기 속성 로드를 시작합니다.
CDataPathProperty::ResetData 컨트롤 속성이 변경되었음을 컨테이너에 알리는 호출 CAsyncMonikerFile::OnDataAvailable 입니다.
CDataPathProperty::SetControl 속성과 연결된 OLE(비동기 ActiveX) 컨트롤을 설정합니다.
CDataPathProperty::SetPath 속성의 경로 이름을 설정합니다.

설명

비동기 속성은 동기 시작 후에 로드됩니다.

클래스 CDataPathProperty 는 .에서 CAysncMonikerFile파생됩니다. OLE 컨트롤에서 비동기 속성을 구현하려면 클래스 CDataPathProperty를 파생시키고 OnDataAvailable을 재정 의합니다.

인터넷 애플리케이션에서 비동기 모니커 및 ActiveX 컨트롤을 사용하는 방법에 대한 자세한 내용은 다음 문서를 참조하세요.

상속 계층 구조

CObject

CFile

COleStreamFile

CMonikerFile

CAsyncMonikerFile

CDataPathProperty

요구 사항

헤더: afxctl.h

CDataPathProperty::CDataPathProperty

CDataPathProperty 개체를 생성합니다.

CDataPathProperty(COleControl* pControl = NULL);
CDataPathProperty(LPCTSTR lpszPath, COleControl* pControl = NULL);

매개 변수

pControl
이 CDataPathProperty 개체와 연결할 OLE 컨트롤 개체에 대한 포인터입니다.

lpszPath
절대 또는 상대 경로는 속성의 실제 절대 위치를 참조하는 비동기 모니커를 만드는 데 사용됩니다. CDataPathProperty 은 파일 이름이 아닌 URL을 사용합니다. 파일의 개체를 CDataPathProperty 원하는 경우 경로 앞에 추가 file:// 합니다.

설명

COleControl pControl에서 가리키는 개체는 파생 클래스에서 Open 사용 및 검색됩니다. pControl이 NULL이면 사용된 Open 컨트롤을 .로 SetControl설정해야 합니다. lpszPath가 NULL인 경우 경로를 Open 전달하거나 .으로 SetPath설정할 수 있습니다.

CDataPathProperty::GetControl

이 멤버 함수를 호출하여 개체와 연결된 개체를 검색 COleControl 합니다 CDataPathProperty .

COleControl* GetControl();

Return Value

개체와 연결된 OLE 컨트롤에 대한 포인터를 CDataPathProperty 반환합니다. 컨트롤이 연결되지 않은 경우 NULL입니다.

CDataPathProperty::GetPath

이 멤버 함수를 호출하여 경로를 검색하거나, 개체가 CDataPathProperty 생성되거나, 지정되거나, 멤버 함수에 Open대한 이전 호출 SetPath 에서 지정된 경우를 설정합니다.

CString GetPath() const;

Return Value

속성 자체에 대한 경로 이름을 반환합니다. 경로가 지정되지 않은 경우 비워 둘 수 있습니다.

CDataPathProperty::Open

이 멤버 함수를 호출하여 연결된 컨트롤에 대한 비동기 속성의 로드를 시작합니다.

virtual BOOL Open(
    COleControl* pControl,
    CFileException* pError = NULL);

virtual BOOL Open(
    LPCTSTR lpszPath,
    COleControl* pControl,
    CFileException* pError = NULL);

virtual BOOL Open(
    LPCTSTR lpszPath,
    CFileException* pError = NULL);

virtual BOOL Open(CFileException* pError = NULL);

매개 변수

pControl
이 CDataPathProperty 개체와 연결할 OLE 컨트롤 개체에 대한 포인터입니다.

pError
파일 예외에 대한 포인터입니다. 오류가 발생할 경우 원인으로 설정됩니다.

lpszPath
절대 또는 상대 경로는 속성의 실제 절대 위치를 참조하는 비동기 모니커를 만드는 데 사용됩니다. CDataPathProperty 은 파일 이름이 아닌 URL을 사용합니다. 파일의 개체를 CDataPathProperty 원하는 경우 경로 앞에 추가 file:// 합니다.

Return Value

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

설명

함수는 컨트롤에서 인터페이스를 IBindHost 가져오려고 시도합니다.

경로 없이 호출 Open 하기 전에 속성 경로 값을 설정해야 합니다. 이 작업은 개체를 생성하거나 멤버 함수를 SetPath 호출하여 수행할 수 있습니다.

컨트롤 없이 호출 Open 하기 전에 ActiveX 컨트롤(이전의 OLE 컨트롤)을 개체와 연결할 수 있습니다. 개체를 생성하거나 호출 SetControl하여 이 작업을 수행할 수 있습니다.

CAsyncMonikerFile::Open의 모든 오버로드도 사용할 수 있습니다CDataPathProperty.

CDataPathProperty::ResetData

컨트롤 속성이 변경되었으며 비동기적으로 로드된 모든 정보가 더 이상 유용하지 않음을 컨테이너에 알리려면 이 함수 CAsyncMonikerFile::OnDataAvailable 를 호출합니다.

virtual void ResetData();

설명

열기를 다시 시작해야 합니다. 파생 클래스는 다른 기본값에 대해 이 함수를 재정의할 수 있습니다.

CDataPathProperty::SetControl

이 멤버 함수를 호출하여 비동기 OLE 컨트롤을 개체와 연결합니다 CDataPathProperty .

void SetControl(COleControl* pControl);

매개 변수

pControl
속성과 연결할 비동기 OLE 컨트롤에 대한 포인터입니다.

CDataPathProperty::SetPath

이 멤버 함수를 호출하여 속성의 경로 이름을 설정합니다.

void SetPath(LPCTSTR lpszPath);

매개 변수

lpszPath
비동기적으로 로드되는 속성에 대한 절대 또는 상대 경로입니다. CDataPathProperty 은 파일 이름이 아닌 URL을 사용합니다. 파일의 개체를 CDataPathProperty 원하는 경우 경로 앞에 추가 file:// 합니다.

참고 항목

MFC 샘플 이미지
CAsyncMonikerFile 클래스
계층 구조 차트
CAsyncMonikerFile 클래스