Класс 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 интерфейс.