Classe CPictureHolder

Implementa uma propriedade Imagem, que permite ao utilizador mostrar uma imagem no seu controlo.

Sintaxe

class CPictureHolder

Membros

Construtores Públicos

Métodos Públicos

Membros de Dados Públicos

Observações

CPictureHolder não tem uma classe base.

Com a propriedade Imagem de stock, o programador pode especificar um bitmap, ícone ou metaficheiro para exibição.

Para informações sobre como criar propriedades de imagem personalizadas, consulte o artigo MFC Controlos ActiveX: Usar Imagens num Controlo ActiveX.

Hierarquia de herança

CPictureHolder

Requerimentos

Cabeçalho: afxctl.h

CPictureHolder::CPictureHolder

Constrói um CPictureHolder objeto.

CPictureHolder();

CPictureHolder::CreateEmpty

Cria um objeto vazio CPictureHolder e liga-o a uma IPicture interface.

BOOL CreateEmpty();

Valor de retorno

Não nulo se o objeto for criado com sucesso; caso contrário, 0.

CPictureHolder::CreateFromBitmap

Usa um bitmap para inicializar o objeto imagem num 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
ID de recurso de um recurso bitmap.

pBitmap
Apontar para um objeto CBitmap .

pPal
Apontar para um objeto CPalette .

bTransferênciaPropriedade
Indica se o objeto imagem irá assumir a propriedade dos objetos bitmap e paleta.

HBM
Handle para o bitmap a partir do qual o CPictureHolder objeto é criado.

HPAL
Handle para a paleta usada para renderizar o bitmap.

Valor de retorno

Não nulo se o objeto for criado com sucesso; caso contrário, 0.

Observações

Se o bTransferOwnership for VERDADEIRO, o chamador não deve usar o bitmap ou o objeto paleta de qualquer forma após o retorno desta chamada. Se o bTransferOwnership for FALSO, o chamador é responsável por garantir que os objetos bitmap e paleta permanecem válidos durante toda a vida útil do objeto imagem.

CPictureHolder::CreateFromIcon

Utiliza um ícone para inicializar o objeto imagem num CPictureHolderarquivo .

BOOL CreateFromIcon(
    UINT idResource);

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

Parâmetros

idResource
ID de recurso de um recurso bitmap.

hIcon
Handle para o ícone a partir do qual o CPictureHolder objeto é criado.

bTransferênciaPropriedade
Indica se o objeto imagem vai assumir a propriedade do objeto ícone.

Valor de retorno

Não nulo se o objeto for criado com sucesso; caso contrário, 0.

Observações

Se o bTransferOwnership for VERDADEIRO, o chamador não deve usar o objeto ícone de qualquer forma após o retorno desta chamada. Se o bTransferOwnership for FALSO, o chamador é responsável por garantir que o objeto ícone permanece válido durante toda a vida útil do objeto imagem.

CPictureHolder::CreateFromMetafile

Utiliza um metaficheiro para inicializar o objeto imagem num CPictureHolderarquivo .

BOOL CreateFromMetafile(
    HMETAFILE hmf,
    int xExt,
    int yExt,
    BOOL bTransferOwnership = FALSE);

Parâmetros

hmf
Handle para o metaficheiro usado para criar o CPictureHolder objeto.

xExt
X extensão da imagem.

yExt
E a extensão da imagem.

bTransferênciaPropriedade
Indica se o objeto imagem irá assumir a propriedade do objeto do metaficheiro.

Valor de retorno

Não nulo se o objeto for criado com sucesso; caso contrário, 0.

Observações

Se o bTransferOwnership for VERDADEIRO, o chamador não deve usar o objeto metafile de qualquer forma após o retorno desta chamada. Se o bTransferOwnership for FALSO, o chamador é responsável por garantir que o objeto metafile permanece válido durante toda a vida útil do objeto imagem.

CPictureHolder::GetDisplayString

Recupera a cadeia que é exibida no browser de propriedades de um contentor.

BOOL GetDisplayString(CString& strValue);

Parâmetros

strValue
Referência ao CString que serve para segurar a cadeia de visualização.

Valor de retorno

Não nula se a corda for recuperada com sucesso; caso contrário, 0.

CPictureHolder::GetPictureDispatch

Esta função devolve um ponteiro para a CPictureHolder interface do IPictureDisp objeto.

LPPICTUREDISP GetPictureDispatch();

Valor de retorno

Um apontador para a CPictureHolder interface do IPictureDisp objeto.

Observações

O interlocutor deve recorrer Release a este indicador quando terminar de o usar.

CPictureHolder::GetType

Indica se a imagem é um bitmap, metaficheiro ou ícone.

short GetType();

Valor de retorno

Um valor que indica o tipo da imagem. Os valores possíveis e os seus significados são os seguintes:

CPictureHolder::m_pPict

Um apontador para a CPictureHolder interface do IPicture objeto.

LPPICTURE m_pPict;

CPictureHolder::Render

Renderiza a imagem no retângulo referenciado pelo rcRender.

void Render(
    CDC* pDC,
    const CRect& rcRender,
    const CRect& rcWBounds);

Parâmetros

pDC
Apontador para o contexto de exibição onde a imagem será renderizada.

rcRender
Retângulo onde a imagem deve ser renderizada.

rcWBounds
Um retângulo que representa o retângulo delimitador do objeto que representa a imagem. Para um controlo, este retângulo é o parâmetro rcBounds passado para uma sobreposição de COleControl::OnDraw.

CPictureHolder::SetPictureDispatch

Liga o CPictureHolder objeto a uma IPictureDisp interface.

void SetPictureDispatch(LPPICTUREDISP pDisp);

Parâmetros

pDisp
Aponta para a nova IPictureDisp interface.

Consulte também

Gráfico de Hierarquia
Classe CFontHolder