CPictureHolder 클래스
사용자가 컨트롤에 그림을 표시할 수 있도록 하는 Picture 속성을 구현합니다.
구문
class CPictureHolder
멤버
공용 생성자
| 속성 | 설명 |
|---|---|
| CPictureHolder::CPictureHolder | CPictureHolder 개체를 생성합니다. |
공용 메서드
| 이름 | 설명 |
|---|---|
| CPictureHolder::CreateEmpty | 빈 CPictureHolder 개체를 만듭니다. |
| CPictureHolder::CreateFromBitmap | CPictureHolder 비트맵에서 개체를 만듭니다. |
| CPictureHolder::CreateFromIcon | 아이콘에서 CPictureHolder 개체를 만듭니다. |
| CPictureHolder::CreateFromMetafile | 메타파일에서 CPictureHolder 개체를 만듭니다. |
| CPictureHolder::GetDisplayString | 컨트롤 컨테이너의 속성 브라우저에 표시되는 문자열을 검색합니다. |
| CPictureHolder::GetPictureDispatch | 개체의 CPictureHolder 인터페이스를 IDispatch 반환합니다. |
| CPictureHolder::GetType | 개체가 CPictureHolder 비트맵, 메타파일 또는 아이콘인지 여부를 알려줍니다. |
| CPictureHolder::Render | 그림을 렌더링합니다. |
| CPictureHolder::SetPictureDispatch | 개체의 인터페이스를 CPictureHolder IDispatch 설정합니다. |
공용 데이터 멤버
| 속성 | 설명 |
|---|---|
| CPictureHolder::m_pPict | 그림 개체에 대한 포인터입니다. |
설명
CPictureHolder 에는 기본 클래스가 없습니다.
Stock Picture 속성을 사용하면 개발자가 표시할 비트맵, 아이콘 또는 메타파일을 지정할 수 있습니다.
사용자 지정 그림 속성을 만드는 방법에 대한 자세한 내용은 MFC ActiveX 컨트롤: ActiveX 컨트롤에서 그림 사용 문서를 참조하세요.
상속 계층 구조
CPictureHolder
요구 사항
헤더: afxctl.h
CPictureHolder::CPictureHolder
CPictureHolder 개체를 생성합니다.
CPictureHolder();
CPictureHolder::CreateEmpty
빈 CPictureHolder 개체를 만들어 인터페이스에 IPicture 연결합니다.
BOOL CreateEmpty();
Return Value
개체가 성공적으로 만들어지면 0이 아닌 경우 그렇지 않으면 0입니다.
CPictureHolder::CreateFromBitmap
비트맵을 사용하여 그림 개체를 초기화합니다 CPictureHolder.
BOOL CreateFromBitmap(
UINT idResource);
BOOL CreateFromBitmap(
CBitmap* pBitmap,
CPalette* pPal = NULL,
BOOL bTransferOwnership = TRUE);
BOOL CreateFromBitmap(
HBITMAP hbm,
HPALETTE hpal = NULL,
BOOL bTransferOwnership = FALSE);
매개 변수
idResource
비트맵 리소스의 리소스 ID입니다.
pBitmap
CBitmap 개체에 대한 포인터입니다.
pPal
CPalette 개체에 대한 포인터입니다.
bTransferOwnership
그림 개체가 비트맵 및 색상표 개체의 소유권을 가져올지 여부를 나타냅니다.
hbm
개체가 만들어지는 비트맵에 대한 CPictureHolder 핸들입니다.
hpal
비트맵을 렌더링하는 데 사용되는 색상표에 대한 핸들입니다.
Return Value
개체가 성공적으로 만들어지면 0이 아닌 경우 그렇지 않으면 0입니다.
설명
bTransferOwnership이 TRUE이면 호출자가 이 호출이 반환된 후 어떤 방식으로든 비트맵 또는 색상표 개체를 사용하면 안 됩니다. bTransferOwnership이 FALSE이면 호출자는 비트맵 및 색상표 개체가 그림 개체의 수명 동안 유효한 상태로 유지되도록 합니다.
CPictureHolder::CreateFromIcon
아이콘을 사용하여 그림 개체를 초기화합니다 CPictureHolder.
BOOL CreateFromIcon(
UINT idResource);
BOOL CreateFromIcon(
HICON hIcon,
BOOL bTransferOwnership = FALSE);
매개 변수
idResource
비트맵 리소스의 리소스 ID입니다.
hIcon
개체가 만들어지는 아이콘에 대한 CPictureHolder 핸들입니다.
bTransferOwnership
그림 개체가 아이콘 개체의 소유권을 가져올지 여부를 나타냅니다.
Return Value
개체가 성공적으로 만들어지면 0이 아닌 경우 그렇지 않으면 0입니다.
설명
bTransferOwnership이 TRUE이면 호출자가 이 호출이 반환된 후 어떤 방식으로든 아이콘 개체를 사용하면 안 됩니다. bTransferOwnership이 FALSE이면 호출자는 아이콘 개체가 그림 개체의 수명 동안 유효한 상태로 유지되도록 합니다.
CPictureHolder::CreateFromMetafile
메타파일을 사용하여 그림 개체를 초기화합니다 CPictureHolder.
BOOL CreateFromMetafile(
HMETAFILE hmf,
int xExt,
int yExt,
BOOL bTransferOwnership = FALSE);
매개 변수
hmf
개체를 만드는 데 사용되는 메타파일을 처리합니다 CPictureHolder .
xExt
그림의 X 익스텐트입니다.
yExt
그림의 Y 범위입니다.
bTransferOwnership
그림 개체가 메타파일 개체의 소유권을 가져올지 여부를 나타냅니다.
Return Value
개체가 성공적으로 만들어지면 0이 아닌 경우 그렇지 않으면 0입니다.
설명
bTransferOwnership이 TRUE이면 호출자가 이 호출이 반환된 후 메타파일 개체를 어떤 방식으로든 사용하면 안 됩니다. bTransferOwnership이 FALSE이면 호출자는 메타파일 개체가 그림 개체의 수명 동안 유효한 상태로 유지되도록 합니다.
CPictureHolder::GetDisplayString
컨테이너의 속성 브라우저에 표시되는 문자열을 검색합니다.
BOOL GetDisplayString(CString& strValue);
매개 변수
strValue
표시 문자열을 저장할 CString 에 대한 참조입니다.
Return Value
문자열이 성공적으로 검색되면 0이 아닌 경우 그렇지 않으면 0입니다.
CPictureHolder::GetPictureDispatch
이 함수는 개체의 IPictureDisp 인터페이스에 대한 포인터를 CPictureHolder 반환합니다.
LPPICTUREDISP GetPictureDispatch();
Return Value
개체의 인터페이스에 대한 CPictureHolder 포인터입니다 IPictureDisp .
설명
호출자는 완료된 경우 이 포인터를 호출 Release 해야 합니다.
CPictureHolder::GetType
그림이 비트맵, 메타파일 또는 아이콘인지 여부를 나타냅니다.
short GetType();
Return Value
그림의 형식을 나타내는 값입니다. 가능한 값과 그 의미는 다음과 같습니다.
| 값 | 의미 |
|---|---|
| PICTYPE_UNINITIALIZED | CPictureHolder 개체가 단위화됩니다. |
| PICTYPE_NONE | CPictureHolder 개체가 비어 있습니다. |
| PICTYPE_BITMAP | 그림은 비트맵입니다. |
| PICTYPE_METAFILE | 그림은 메타파일입니다. |
| PICTYPE_ICON | 그림은 아이콘입니다. |
CPictureHolder::m_pPict
개체의 인터페이스에 대한 CPictureHolder 포인터입니다 IPicture .
LPPICTURE m_pPict;
CPictureHolder::Render
rcRender에서 참조하는 사각형의 그림을 렌더링합니다.
void Render(
CDC* pDC,
const CRect& rcRender,
const CRect& rcWBounds);
매개 변수
pDC
그림을 렌더링할 표시 컨텍스트에 대한 포인터입니다.
rcRender
그림을 렌더링할 사각형입니다.
rcWBounds
그림을 렌더링하는 개체의 경계 사각형을 나타내는 사각형입니다. 컨트롤의 경우 이 사각형은 COleControl::OnDraw의 재정의에 전달되는 rcBounds 매개 변수입니다.
CPictureHolder::SetPictureDispatch
개체를 CPictureHolder 인터페이스에 IPictureDisp 연결합니다.
void SetPictureDispatch(LPPICTUREDISP pDisp);
매개 변수
pDisp
새 IPictureDisp 인터페이스에 대한 포인터입니다.