Compartilhar via


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.

Confira também

Gráfico da hierarquia
Classe CFontHolder