Класс 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 не имеет базового класса.

С помощью свойства "Рисунок" разработчик может указать растровое изображение, значок или метафайл для отображения.

Дополнительные сведения о создании настраиваемых свойств рисунков см. в статье MFC ActiveX Controls: Использование рисунков в элементе ActiveX.

Иерархия наследования

CPictureHolder

Требования

Заголовок: afxctl.h

CPictureHolder::CPictureHolder

Формирует объект CPictureHolder.

CPictureHolder();

CPictureHolder::CreateEmpty

Создает пустой CPictureHolder объект и подключает его к интерфейсу IPicture .

BOOL CreateEmpty();

Возвращаемое значение

Ненулевое значение, если объект успешно создан; в противном случае — 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
Идентификатор ресурса растрового изображения.

pBitmap
Указатель на объект CBitmap .

pPal
Указатель на объект CPalette .

bTransferOwnership
Указывает, будет ли объект рисунка обладать объектами растровой карты и палитры.

Hbm
Дескриптор растрового CPictureHolder изображения, из которого создается объект.

hpal
Дескриптор палитры, используемой для отрисовки растрового изображения.

Возвращаемое значение

Ненулевое значение, если объект успешно создан; в противном случае — 0.

Замечания

Если bTransferOwnership имеет значение TRUE, вызывающий объект не должен использовать растровое изображение или объект палитры каким-либо образом после возврата этого вызова. Если значение bTransferOwnership равно FALSE, вызывающий объект отвечает за обеспечение того, чтобы объекты растрового изображения и палитры оставались действительными в течение всего времени существования объекта рисунка.

CPictureHolder::CreateFromIcon

Использует значок для инициализации объекта рисунка в объекте CPictureHolder.

BOOL CreateFromIcon(
    UINT idResource);

BOOL CreateFromIcon(
    HICON hIcon,
    BOOL bTransferOwnership = FALSE);

Параметры

idResource
Идентификатор ресурса растрового изображения.

hIcon
Дескриптор значка CPictureHolder , из которого создается объект.

bTransferOwnership
Указывает, будет ли объект рисунка обладать объектом значка.

Возвращаемое значение

Ненулевое значение, если объект успешно создан; в противном случае — 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
Указывает, будет ли объект рисунка храняться в объекте метафайла.

Возвращаемое значение

Ненулевое значение, если объект успешно создан; в противном случае — 0.

Замечания

Если значение bTransferOwnership равно TRUE, вызывающий объект метафайла не должен использовать каким-либо образом после возврата этого вызова. Если bTransferOwnership имеет значение FALSE, вызывающий объект отвечает за то, что объект метафайла остается действительным в течение времени существования объекта рисунка.

CPictureHolder::GetDisplayString

Извлекает строку, отображаемую в браузере свойств контейнера.

BOOL GetDisplayString(CString& strValue);

Параметры

strValue
Ссылка на CString , которая содержит отображаемую строку.

Возвращаемое значение

Ненулевое значение, если строка успешно извлечена; в противном случае — 0.

CPictureHolder::GetPictureDispatch

Эта функция возвращает указатель на CPictureHolder интерфейс объекта IPictureDisp .

LPPICTUREDISP GetPictureDispatch();

Возвращаемое значение

Указатель на CPictureHolder интерфейс объекта IPictureDisp .

Замечания

Вызывающий объект должен вызвать Release этот указатель после завершения работы с ним.

CPictureHolder::GetType

Указывает, является ли рисунок растровым изображением, метафайлом или значком.

short GetType();

Возвращаемое значение

Значение, указывающее тип рисунка. Возможные значения и их значения:

Значение	Значение
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
Прямоугольник, представляющий ограничивающий прямоугольник объекта отрисовки рисунка. Для элемента управления этот прямоугольник является параметром rcBounds , переданным переопределением COleControl::OnDraw.

CPictureHolder::SetPictureDispatch

CPictureHolder Подключение объект в IPictureDisp интерфейс.

void SetPictureDispatch(LPPICTUREDISP pDisp);

Параметры

pDisp
Указатель на новый IPictureDisp интерфейс.

См. также

Диаграмма иерархии
Класс CFontHolder