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

Métodos públicos

Membros de Dados Públicos

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:

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