Classe CPictureHolder
Implementa uma propriedade de imagem, que permite ao usuário exibir uma imagem no seu controle.
Sintaxe
class CPictureHolder
Membros
Construtores públicos
| Nome | Descrição |
|---|---|
| CPictureHolder::CPictureHolder | Constrói um objeto CPictureHolder. |
Métodos públicos
| Nome | Descrição |
|---|---|
| CPictureHolder::CreateEmpty | Cria um objeto CPictureHolder vazio. |
| CPictureHolder::CreateFromBitmap | Cria um objeto CPictureHolder a partir de um bitmap. |
| CPictureHolder::CreateFromIcon | Cria um objeto CPictureHolder a partir de um ícone. |
| CPictureHolder::CreateFromMetafile | Cria um objeto CPictureHolder a partir de um metarquivo. |
| CPictureHolder::GetDisplayString | Recupera a cadeia de caracteres exibida no navegador de propriedades de um contêiner de controle. |
| CPictureHolder::GetPictureDispatch | Retorna a interface IDispatch do objeto CPictureHolder. |
| CPictureHolder::GetType | Informa se o objeto CPictureHolder é um bitmap, um metarquivo ou um ícone. |
| CPictureHolder::Render | Renderiza a imagem. |
| CPictureHolder::SetPictureDispatch | Define a interface IDispatch do objeto CPictureHolder. |
Membros de Dados Públicos
| Nome | Descrição |
|---|---|
| CPictureHolder::m_pPict | Um ponteiro para um objeto de imagem. |
Comentários
CPictureHolder não tem uma classe base.
Com a propriedade de Imagem de estoque, o desenvolvedor pode especificar um bitmap, ícone ou metarquivo para exibição.
Para obter informações sobre como criar propriedades de imagem personalizadas, consulte o artigo Controles ActiveX MFC: Usar imagens em um controle ActiveX.
Hierarquia de herança
CPictureHolder
Requisitos
Cabeçalho: afxctl.h
CPictureHolder::CPictureHolder
Constrói um objeto CPictureHolder.
CPictureHolder();
CPictureHolder::CreateEmpty
Cria um objeto vazio CPictureHolder e o conecta a uma interface IPicture.
BOOL CreateEmpty();
Valor de retorno
Não zero se o objeto for criado com êxito; caso contrário, 0.
CPictureHolder::CreateFromBitmap
Usa um bitmap para inicializar o objeto de imagem em um 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);
Parâmetros
idResource
A ID de um recurso bitmap.
pBitmap
Ponteiro para um objeto CBitmap.
pPal
Ponteiro para um objeto CPalette.
bTransferOwnership
Indica se o objeto de imagem assumirá a propriedade dos objetos bitmap e paleta.
hbm
Identificador do bitmap a partir do qual o objeto CPictureHolder é criado.
hpal
Identificador da paleta usada para renderizar o bitmap.
Valor de retorno
Não zero se o objeto for criado com êxito; caso contrário, 0.
Comentários
Se bTransferOwnership for TRUE, o chamador não deverá usar o objeto bitmap ou paleta de forma alguma após o retorno dessa chamada. Se bTransferOwnership for FALSE, o chamador será responsável por garantir que os objetos bitmap e paleta permaneçam válidos durante o tempo de vida do objeto de imagem.
CPictureHolder::CreateFromIcon
Usa um ícone para inicializar o objeto de imagem em um CPictureHolder.
BOOL CreateFromIcon(
UINT idResource);
BOOL CreateFromIcon(
HICON hIcon,
BOOL bTransferOwnership = FALSE);
Parâmetros
idResource
A ID de um recurso bitmap.
hIcon
Identificador do ícone a partir do qual o objeto CPictureHolder é criado.
bTransferOwnership
Indica se o objeto de imagem assumirá a propriedade do objeto ícone.
Valor de retorno
Não zero se o objeto for criado com êxito; caso contrário, 0.
Comentários
Se bTransferOwnership for TRUE, o chamador não deverá usar o objeto ícone de forma alguma após o retorno dessa chamada. Se bTransferOwnership for FALSE, o chamador será responsável por garantir que o objeto ícone permaneça válido durante o tempo de vida do objeto de imagem.
CPictureHolder::CreateFromMetafile
Usa um metarquivo para inicializar o objeto de imagem em um CPictureHolder.
BOOL CreateFromMetafile(
HMETAFILE hmf,
int xExt,
int yExt,
BOOL bTransferOwnership = FALSE);
Parâmetros
hmf
Identificador do metarquivo usado para criar o objeto CPictureHolder.
xExt
Extensão X da imagem.
yExt
Extensão Y da imagem.
bTransferOwnership
Indica se o objeto de imagem assumirá a propriedade do objeto metarquivo.
Valor de retorno
Não zero se o objeto for criado com êxito; caso contrário, 0.
Comentários
Se bTransferOwnership for TRUE, o chamador não deverá usar o objeto metarquivo de forma alguma após o retorno dessa chamada. Se bTransferOwnership for FALSE, o chamador será responsável por garantir que o objeto metarquivo permaneça válido durante o tempo de vida do objeto de imagem.
CPictureHolder::GetDisplayString
Recupera a cadeia de caracteres exibida no navegador de propriedades de um contêiner.
BOOL GetDisplayString(CString& strValue);
Parâmetros
strValue
Referência ao CString destinado a manter a cadeia de caracteres de exibição.
Valor de retorno
Não zero se a cadeia de caracteres for recuperada com êxito; caso contrário, 0.
CPictureHolder::GetPictureDispatch
Essa função retorna um ponteiro para a interface CPictureHolder do objeto IPictureDisp.
LPPICTUREDISP GetPictureDispatch();
Valor de retorno
Um ponteiro para a interface IPictureDisp do objeto CPictureHolder.
Comentários
O chamador deve chamar Release esse ponteiro ao concluir com ele.
CPictureHolder::GetType
Indica se a imagem é um bitmap, um metarquivo ou um ícone.
short GetType();
Valor de retorno
Um valor que indica o tipo da imagem. Os possíveis valores e seus significados são os seguintes:
| Valor | Significado |
|---|---|
| PICTYPE_UNINITIALIZED | O objetoCPictureHolder está desinicializado. |
| PICTYPE_NONE | O objetoCPictureHolder está vazio. |
| PICTYPE_BITMAP | A imagem é um bitmap. |
| PICTYPE_METAFILE | A imagem é um metarquivo. |
| PICTYPE_ICON | A imagem é um ícone. |
CPictureHolder::m_pPict
Um ponteiro para a interface IPicture do objeto CPictureHolder.
LPPICTURE m_pPict;
CPictureHolder::Render
Renderiza a imagem no retângulo referenciado por rcRender.
void Render(
CDC* pDC,
const CRect& rcRender,
const CRect& rcWBounds);
Parâmetros
pDC
Ponteiro para o contexto de exibição no qual a imagem deve ser renderizada.
rcRender
Retângulo no qual a imagem deve ser renderizada.
rcWBounds
Um retângulo que representa o retângulo delimitador do objeto que renderiza a imagem. Para um controle, esse retângulo é o parâmetro rcBounds passado para uma substituição de COleControl::OnDraw.
CPictureHolder::SetPictureDispatch
Conecta o objeto CPictureHolder a uma interface IPictureDisp.
void SetPictureDispatch(LPPICTUREDISP pDisp);
Parâmetros
pDisp
Ponteiro para a nova interface IPictureDisp.