Partilhar via


Classe CStockPropImpl

Observação

A Active Template Library (ATL) continua a ser suportada. No entanto, já não estamos a adicionar funcionalidades nem a atualizar a documentação.

Esta disciplina fornece métodos para suportar o valor das propriedades de ações.

Importante

Esta classe e os seus membros não podem ser usados em aplicações que sejam executadas no Windows Runtime.

Sintaxe

template <
    class T,
    class InterfaceName,
    const IID* piid = &_ATL_IIDOF(InterfaceName),
    const GUID* plibid = &CComModule::m_libid,
    WORD wMajor = 1,
    WORD wMinor = 0,
    class tihclass = CcomTypeInfoHolder>
class ATL_NO_VTABLE CStockPropImpl :
    public IDispatchImpl<InterfaceName, piid, plibid, wMajor, wMinor, tihclass>

Parâmetros

T
A classe que implementa o controlo e deriva de CStockPropImpl.

InterfaceName
Uma interface dupla que expõe as propriedades originais.

Piid
Um apontador para o IID de InterfaceName.

plibid
Um apontador para o LIBID da biblioteca de tipos que contém a definição de InterfaceName.

wMajor
A versão principal da biblioteca de tipos. O valor padrão é 1.

wMinor
A versão menor da biblioteca de tipos. O valor padrão é 0.

tihclass
A classe utilizada para gerir a informação de tipo para T. O valor padrão é CComTypeInfoHolder.

Membros

Métodos Públicos

Nome Description
get_Appearance Chame-se a este método para obter o estilo de pintura usado pelo controlo, por exemplo, plano ou 3D.
get_AutoSize Chame este método para obter o estado da bandeira que indica se o controlo não pode ser de outro tamanho.
get_BackColor Chame este método para obter a cor de fundo do controlo.
get_BackStyle Chame este método para obter o estilo de fundo do controlo, seja transparente ou opaco.
get_BorderColor Chame este método para obter a cor da borda do controlo.
get_BorderStyle Chame-se a este método para obter o estilo da borda do controlo.
get_BorderVisible Chame este método para obter o estado da bandeira que indica se a fronteira do controlo é visível ou não.
get_BorderWidth Chame este método para obter a largura (em pixels) da borda do controlo.
get_Caption Chame este método para obter o texto especificado na legenda de um objeto.
get_DrawMode Chame este método para obter o modo de desenho do controlo, por exemplo, Caneta XOR ou Inverter Cores.
get_DrawStyle Chame-se a este método para obter o estilo de desenho do controlo, por exemplo, sólido, traçado ou pontilhado.
get_DrawWidth Chame este método para obter a largura de desenho (em píxeis) usada pelos métodos de desenho do controlo.
get_Enabled Chame este método para obter o estado da bandeira que indica se o controlo está ativado.
get_FillColor Chame este método para obter a cor de preenchimento do controlo.
get_FillStyle Chame-se a este método para obter o estilo de preenchimento do controlo, por exemplo, sólido, transparente ou com hachuras cruzadas.
get_Font Chame este método para obter um ponteiro para as propriedades da fonte do controlo.
get_ForeColor Chame este método para obter a cor do primeiro plano do controlo.
get_HWND Chame este método para obter a maçaneta da janela associada ao controlo.
get_MouseIcon Chame este método para obter as propriedades da imagem do gráfico (ícone, bitmap ou metaficheiro) a serem exibidas quando o rato estiver sobre o controlo.
get_MousePointer Chame este método para obter o tipo de ponteiro do rato exibido quando o rato está sobre o controlo, por exemplo, seta, cruz ou ampulheta.
get_Picture Chame este método para obter um ponteiro para as propriedades da imagem de um gráfico (ícone, bitmap ou metaficheiro) a ser exibido.
get_ReadyState Chame este método para obter o estado de pronto do controlo, por exemplo, carregando ou carregado.
get_TabStop Chame este método para obter a bandeira que indica se o controlo é um tab stop ou não.
get_Text Chame este método para obter o texto que é exibido com o controlo.
getvalid Chame este método para obter o estado da bandeira que indica se o controlo é válido ou não.
get_Window Chame este método para obter a maçaneta da janela associada ao controlo. Idêntico ao CStockPropImpl::get_HWND.
put_Appearance Chame este método para definir o estilo de pintura usado pelo controlo, por exemplo, plano ou 3D.
put_AutoSize Chame este método para definir o valor da bandeira que indica se o controlo não pode ter outro tamanho.
put_BackColor Chame este método para definir a cor de fundo do controlo.
put_BackStyle Chame este método para definir o estilo de fundo do controlo.
put_BorderColor Chame este método para definir a cor da borda do controlo.
put_BorderStyle Chame este método para definir o estilo da borda do controlo.
put_BorderVisible Chame este método para definir o valor da bandeira que indica se a borda do controlo é visível ou não.
put_BorderWidth Chame este método para definir a largura da borda do controlo.
put_Caption Chame este método para definir o texto para ser exibido com o controlo.
put_DrawMode Chame este método para definir o modo de desenho do controlo, por exemplo, Caneta XOR ou Inverter Cores.
put_DrawStyle Chame a este método para definir o estilo de desenho do controlo, por exemplo, sólido, tracejado ou pontilhado.
put_DrawWidth Chame este método para definir a largura (em pixels) usada pelos métodos de desenho do controlo.
put_Enabled Chame este método para definir a bandeira que indica se o controlo está ativado.
put_FillColor Chame este método para definir a cor de preenchimento do controlo.
put_FillStyle Chame-se este método para definir o estilo de preenchimento do controlo, por exemplo, sólido, transparente ou com hachuras cruzadas.
put_Font Chame este método para definir as propriedades da fonte do controlo.
put_ForeColor Chame este método para definir a cor do primeiro plano do controlo.
put_HWND Este método devolve E_FAIL.
put_MouseIcon Chame este método para definir as propriedades da imagem do gráfico (ícone, bitmap ou metaficheiro) para serem exibidas quando o rato estiver sobre o controlo.
put_MousePointer Chame este método para definir o tipo de ponteiro do rato exibido quando o rato está sobre o controlo, por exemplo, seta, cruz ou ampulheta.
put_Picture Chame este método para definir as propriedades da imagem de um gráfico (ícone, bitmap ou metaficheiro) a serem exibidas.
put_ReadyState Chame este método para definir o estado de prontidão do controlo, por exemplo, carregando ou carregado.
put_TabStop Chame este método para definir o valor da flag que indica se o controlo é um tab stop ou não.
put_Text Chame este método para definir o texto que é exibido com o controlo.
Putválido Chame este método para definir a bandeira que indica se o controlo é válido ou não.
put_Window Este método chama CStockPropImpl::p ut_HWND, que devolve E_FAIL.
putref_Font Chame este método para definir as propriedades da fonte do controlo, com uma contagem de referências.
putref_MouseIcon Chame este método para definir as propriedades da imagem do gráfico (ícone, mapa de bits ou metaficheiro) para serem exibidas quando o rato estiver sobre o controlo, com uma contagem de referência.
putref_Picture Chame este método para definir as propriedades da imagem de um gráfico (ícone, bitmap ou metaficheiro) a serem exibidas, com uma contagem de referências.

Observações

CStockPropImpl Fornece métodos de put e compra para cada propriedade de ações. Estes métodos fornecem o código necessário para definir ou obter o membro de dados associado a cada propriedade e para notificar e sincronizar com o contentor quando alguma propriedade muda.

O Visual Studio oferece suporte para propriedades stock através dos seus assistentes. Para mais informações sobre como adicionar propriedades de stock a um controlo, consulte o Tutorial ATL.

Para compatibilidade retroativa, CStockPropImpl também expõe get_Window e put_Window métodos que simplesmente chamam get_HWND e put_HWND, respetivamente. A implementação padrão dos put_HWND retornos E_FAIL uma vez que o HWND deve ser uma propriedade de apenas leitura.

As seguintes propriedades também têm uma implementação de putref :

  • Fonte

  • MouseIcon

  • Imagem

As mesmas três propriedades de stock exigem que o seu elemento de dados correspondente seja do tipo CComPtr ou de alguma outra classe que forneça a contagem correta de referências de interface através do operador de atribuição.

Hierarquia de herança

T

IDispatchImpl

CStockPropImpl

Requerimentos

Cabeçalho: atlctl.h

CStockPropImpl::get_Appearance

Chame-se a este método para obter o estilo de pintura usado pelo controlo, por exemplo, plano ou 3D.

HRESULT STDMETHODCALLTYPE get_Appearance(SHORT pnAppearance);

Parâmetros

pnAparência
Variável que recebe o estilo de pintura do controlo.

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

CStockPropImpl::get_AutoSize

Chame este método para obter o estado da bandeira que indica se o controlo não pode ser de outro tamanho.

HRESULT STDMETHODCALLTYPE get_Autosize(VARIANT_BOOL* pbAutoSize);

Parâmetros

pbAutoSize
Variável que recebe o estado da bandeira. TRUE indica que o controlo não pode ser de outro tamanho.

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

CStockPropImpl::get_BackColor

Chame este método para obter a cor de fundo do controlo.

HRESULT STDMETHODCALLTYPE get_BackColor(OLE_COLOR* pclrBackColor);

Parâmetros

pclrBackColor
Variável que recebe a cor de fundo do controlo.

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

CStockPropImpl::get_BackStyle

Chame este método para obter o estilo de fundo do controlo, seja transparente ou opaco.

HRESULT STDMETHODCALLTYPE get_BackStyle(LONG* pnBackStyle);

Parâmetros

pnBackStyle
Variável que recebe o estilo de fundo do controlo.

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

CStockPropImpl::get_BorderColor

Chame este método para obter a cor da borda do controlo.

HRESULT STDMETHODCALLTYPE get_BorderColor(OLE_COLOR* pclrBorderColor);

Parâmetros

pclrBorderColor
Variável que recebe a cor da borda do controlo.

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

CStockPropImpl::get_BorderStyle

Chame-se a este método para obter o estilo da borda do controlo.

HRESULT STDMETHODCALLTYPE get_BorderStyle(LONG* pnBorderStyle);

Parâmetros

pnBorderStyle
Variável que recebe o estilo de borda do controlo.

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

CStockPropImpl::get_BorderVisible

Chame este método para obter o estado da bandeira que indica se a fronteira do controlo é visível ou não.

HRESULT STDMETHODCALLTYPE get_BorderVisible(VARIANT_BOOL* pbBorderVisible);

Parâmetros

pbBorderVisible
Variável que recebe o estado da bandeira. TRUE indica que a fronteira do controlo é visível.

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

CStockPropImpl::get_BorderWidth

Chame este método para obter a largura da borda do controlo.

HRESULT STDMETHODCALLTYPE get_BorderWidth(LONG* pnBorderWidth);

Parâmetros

pnBorderWidth
Variável que recebe a largura da borda do controlo.

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

CStockPropImpl::get_Caption

Chame este método para obter o texto especificado na legenda de um objeto.

HRESULT STDMETHODCALLTYPE get_Caption(BSTR* pbstrCaption);

Parâmetros

pbstrCaption
O texto a ser exibido com o controlo.

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

CStockPropImpl::get_DrawMode

Chame este método para obter o modo de desenho do controlo, por exemplo, Caneta XOR ou Inverter Cores.

HRESULT STDMETHODCALLTYPE get_DrawMode(LONG* pnDrawMode);

Parâmetros

pnDrawMode
Variável que recebe o modo de desenho do controlo.

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

CStockPropImpl::get_DrawStyle

Chame-se a este método para obter o estilo de desenho do controlo, por exemplo, sólido, traçado ou pontilhado.

HRESULT STDMETHODCALLTYPE get_DrawStyle(LONG* pnDrawStyle);

Parâmetros

pnDrawStyle
Variável que recebe o estilo de desenho do controlo.

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

CStockPropImpl::get_DrawWidth

Chame este método para obter a largura de desenho (em píxeis) usada pelos métodos de desenho do controlo.

HRESULT STDMETHODCALLTYPE get_DrawWidth(LONG* pnDrawWidth);

Parâmetros

pnDrawWidth
Variável que recebe o valor de largura do controlo, em pixels.

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

CStockPropImpl::get_Enabled

Chame este método para obter o estado da bandeira que indica se o controlo está ativado.

HRESULT STDMETHODCALLTYPE get_Enabled(VARIANT_BOOL* pbEnabled);

Parâmetros

pbEnabled
Variável que recebe o estado da bandeira. TRUE indica que o controlo está ativado.

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

CStockPropImpl::get_FillColor

Chame este método para obter a cor de preenchimento do controlo.

HRESULT STDMETHODCALLTYPE get_FillColor(OLE_COLOR* pclrFillColor);

Parâmetros

pclrFillColor
Variável que recebe a cor de preenchimento do controlo.

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

CStockPropImpl::get_FillStyle

Chame-se este método para obter o estilo de preenchimento do controlo, por exemplo, sólido, transparente ou com hachuras cruzadas.

HRESULT STDMETHODCALLTYPE get_FillStyle(LONG* pnFillStyle);

Parâmetros

pnFillStyle
Variável que recebe o estilo de preenchimento do controlo.

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

CStockPropImpl::get_Font

Chame este método para obter um ponteiro para as propriedades da fonte do controlo.

HRESULT STDMETHODCALLTYPE get_Font(IFontDisp** ppFont);

Parâmetros

ppFont
Variável que recebe um ponteiro para as propriedades da fonte do controlo.

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

CStockPropImpl::get_ForeColor

Chame este método para obter a cor do primeiro plano do controlo.

HRESULT STDMETHODCALLTYPE get_ForeColor(OLE_COLOR* pclrForeColor);

Parâmetros

pclrForeColor
Variável que recebe a cor do primeiro plano dos controlos.

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

CStockPropImpl::get_HWND

Chame este método para obter a maçaneta da janela associada ao controlo.

HRESULT STDMETHODCALLTYPE get_HWND(LONG_PTR* phWnd);

Parâmetros

phWnd
A maçaneta da janela associada ao controlo.

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

CStockPropImpl::get_MouseIcon

Chame este método para obter as propriedades da imagem do gráfico (ícone, bitmap ou metaficheiro) a serem exibidas quando o rato estiver sobre o controlo.

HRESULT STDMETHODCALLTYPE get_MouseIcon(IPictureDisp** ppPicture);

Parâmetros

ppPicture
Variável que recebe um apontador para as propriedades da imagem do gráfico.

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

CStockPropImpl::get_MousePointer

Chame este método para obter o tipo de ponteiro do rato exibido quando o rato está sobre o controlo, por exemplo, seta, cruz ou ampulheta.

HRESULT STDMETHODCALLTYPE get_MousePointer(LONG* pnMousePointer);

Parâmetros

pnMousePointer
Variável que recebe o tipo de ponteiro do rato.

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

CStockPropImpl::get_Picture

Chame este método para obter um ponteiro para as propriedades da imagem de um gráfico (ícone, bitmap ou metaficheiro) a ser exibido.

HRESULT STDMETHODCALLTYPE get_Picture(IPictureDisp** ppPicture);

Parâmetros

ppPicture
Variável que recebe um ponteiro para as propriedades da imagem. Consulte IPictureDisp para mais detalhes.

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

CStockPropImpl::get_ReadyState

Chame este método para obter o estado de pronto do controlo, por exemplo, carregando ou carregado.

HRESULT STDMETHODCALLTYPE get_ReadyState(LONG* pnReadyState);

Parâmetros

pnReadyState
Variável que recebe o estado de prontidão do controlo.

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

CStockPropImpl::get_TabStop

Chame este método para obter o estado da bandeira que indica se o controlo é um tab stop ou não.

HRESULT STDMETHODCALLTYPE get_TabStop(VARIANT_BOOL* pbTabStop);

Parâmetros

pbTabStop
Variável que recebe o estado da bandeira. TRUE indica que o controlo é um tab stop.

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

CStockPropImpl::get_Text

Chame este método para obter o texto que é exibido com o controlo.

HRESULT STDMETHODCALLTYPE get_Text(BSTR* pbstrText);

Parâmetros

pbstrText
O texto que é mostrado com o controlo.

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

CStockPropImpl::getvalid

Chame este método para obter o estado da bandeira que indica se o controlo é válido ou não.

HRESULT STDMETHODCALLTYPE getvalid(VARIANT_BOOL* pbValid);

Parâmetros

pbValid
Variável que recebe o estado da bandeira. TRUE indica que o controlo é válido.

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

CStockPropImpl::get_Window

Chame este método para obter a maçaneta da janela associada ao controlo. Idêntico ao CStockPropImpl::get_HWND.

HRESULT STDMETHODCALLTYPE get_Window(LONG_PTR* phWnd);

Parâmetros

phWnd
A maçaneta da janela associada ao controlo.

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

CStockPropImpl::p ut_Appearance

Chame este método para definir o estilo de pintura usado pelo controlo, por exemplo, plano ou 3D.

HRESULT STDMETHODCALLTYPE put_Appearance(SHORT nAppearance);

Parâmetros

n Aparência
O novo estilo de pintura será usado pelo comando.

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

CStockPropImpl::p ut_AutoSize

Chame este método para definir o valor de flag que indica se o controlo não pode ter outro tamanho.

HRESULT STDMETHODCALLTYPE put_AutoSize(VARIANT_BOOL bAutoSize);

Parâmetros

bAutoSize
VERDADE se o controlo não puder ser de outro tamanho.

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

CStockPropImpl::p ut_BackColor

Chame este método para definir a cor de fundo do controlo.

HRESULT STDMETHODCALLTYPE put_BackColor(OLE_COLOR clrBackColor);

Parâmetros

clrBackColor
A nova cor de fundo dos controlos.

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

CStockPropImpl::p ut_BackStyle

Chame este método para definir o estilo de fundo do controlo.

HRESULT STDMETHODCALLTYPE put_BackStyle(LONG nBackStyle);

Parâmetros

nBackStyle
O novo estilo de fundo de controlo.

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

CStockPropImpl::p ut_BorderColor

Chame este método para definir a cor da borda do controlo.

HRESULT STDMETHODCALLTYPE put_BorderColor(OLE_COLOR clrBorderColor);

Parâmetros

clrBorderColor
A nova cor da borda. O tipo de dado OLE_COLOR é representado internamente como um inteiro de 32 bits.

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

CStockPropImpl::p ut_BorderStyle

Chame este método para definir o estilo da borda do controlo.

HRESULT STDMETHODCALLTYPE put_BorderStyle(LONG nBorderStyle);

Parâmetros

nBorderStyle
O novo estilo de borda.

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

CStockPropImpl::p ut_BorderVisible

Chame este método para definir o valor da bandeira que indica se a borda do controlo é visível ou não.

HRESULT STDMETHODCALLTYPE put_BorderVisible(VARIANT_BOOL bBorderVisible);

Parâmetros

bBorderVisible
VERDADEIRO se a fronteira for visível.

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

CStockPropImpl::p ut_BorderWidth

Chame este método para definir a largura da borda do controlo.

HRESULT STDMETHODCALLTYPE put_BorderWidth(LONG nBorderWidth);

Parâmetros

nLarguraDeFronteira
A nova largura da fronteira do controlo.

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

CStockPropImpl::p ut_Caption

Chame este método para definir o texto para ser exibido com o controlo.

HRESULT STDMETHODCALLTYPE put_Caption(BSTR bstrCaption);

Parâmetros

bstrCaption
O texto a ser exibido com o controlo.

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

CStockPropImpl::p ut_DrawMode

Chame este método para definir o modo de desenho do controlo, por exemplo, Caneta XOR ou Inverter Cores.

HRESULT STDMETHODCALLTYPE put_DrawMode(LONG nDrawMode);

Parâmetros

nDrawMode
O novo modo de desenho para o controlo.

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

CStockPropImpl::p ut_DrawStyle

Chame a este método para definir o estilo de desenho do controlo, por exemplo, sólido, tracejado ou pontilhado.

HRESULT STDMETHODCALLTYPE put_DrawStyle(LONG pnDrawStyle);

Parâmetros

nDrawStyle
O novo estilo de desenho para o controlo.

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

CStockPropImpl::p ut_DrawWidth

Chame este método para definir a largura (em pixels) usada pelos métodos de desenho do controlo.

HRESULT STDMETHODCALLTYPE put_DrawWidth(LONG nDrawWidth);

Parâmetros

nDrawWidth
A nova largura a ser usada pelos métodos de desenho do controlo.

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

CStockPropImpl::p ut_Enabled

Chame este método para definir o valor da bandeira que indica se o controlo está ativado.

HRESULT STDMETHODCALLTYPE put_Enabled(VARIANT_BOOL bEnabled);

Parâmetros

bAtivado
TRUE se o controlo estiver ativado.

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

CStockPropImpl::p ut_FillColor

Chame este método para definir a cor de preenchimento do controlo.

HRESULT STDMETHODCALLTYPE put_FillColor(OLE_COLOR clrFillColor);

Parâmetros

clrFillColor
A nova cor de preenchimento para o controlo.

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

CStockPropImpl::p ut_FillStyle

Chame-se este método para definir o estilo de preenchimento do controlo, por exemplo, sólido, transparente ou com hachuras cruzadas.

HRESULT STDMETHODCALLTYPE put_FillStyle(LONG nFillStyle);

Parâmetros

nFillStyle
O novo estilo de preenchimento para o controlo.

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

CStockPropImpl::p ut_Font

Chame este método para definir as propriedades da fonte do controlo.

HRESULT STDMETHODCALLTYPE put_Font(IFontDisp* pFont);

Parâmetros

pFont
Um apontador para as propriedades da fonte do controlo.

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

CStockPropImpl::p ut_ForeColor

Chame este método para definir a cor do primeiro plano do controlo.

HRESULT STDMETHODCALLTYPE put_ForeColor(OLE_COLOR clrForeColor);

Parâmetros

clrForeColor
A nova cor em primeiro plano do controlo.

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

CStockPropImpl::p ut_HWND

Este método devolve E_FAIL.

HRESULT STDMETHODCALLTYPE put_HWND(LONG_PTR /* hWnd */);

Parâmetros

hWnd
Reservado.

Valor de retorno

Devolve E_FAIL.

Observações

A maçaneta da janela é um valor de apenas leitura.

CStockPropImpl::p ut_MouseIcon

Chame este método para definir as propriedades da imagem do gráfico (ícone, bitmap ou metaficheiro) para serem exibidas quando o rato estiver sobre o controlo.

HRESULT STDMETHODCALLTYPE put_MouseIcon(IPictureDisp* pPicture);

Parâmetros

pImagem
Um apontador para as propriedades da imagem do gráfico.

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

CStockPropImpl::p ut_MousePointer

Chame este método para definir o tipo de ponteiro do rato exibido quando o rato está sobre o controlo, por exemplo, seta, cruz ou ampulheta.

HRESULT STDMETHODCALLTYPE put_MousePointer(LONG nMousePointer);

Parâmetros

nMousePointer
O tipo de apontador de rato.

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

CStockPropImpl::p ut_Picture

Chame este método para definir as propriedades da imagem de um gráfico (ícone, bitmap ou metaficheiro) a serem exibidas.

HRESULT STDMETHODCALLTYPE put_Picture(IPictureDisp* pPicture);

Parâmetros

pImagem
Um indicador das propriedades da imagem. Consulte IPictureDisp para mais detalhes.

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

CStockPropImpl::p ut_ReadyState

Chame este método para definir o estado de prontidão do controlo, por exemplo, carregando ou carregado.

HRESULT STDMETHODCALLTYPE put_ReadyState(LONG nReadyState);

Parâmetros

nReadyState
O controlo está pronto.

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

CStockPropImpl::p ut_TabStop

Chame este método para definir a bandeira que indica se o controlo é um tab stop ou não.

HRESULT STDMETHODCALLTYPE put_TabStop(VARIANT_BOOL bTabStop);

Parâmetros

bTabStop
VERDADE se o controlo for um tab stop.

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

CStockPropImpl::p ut_Text

Chame este método para definir o texto que é exibido com o controlo.

HRESULT STDMETHODCALLTYPE put_Text(BSTR bstrText);

Parâmetros

bstrText
O texto que é mostrado com o controlo.

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

CStockPropImpl::p utválido

Chame este método para definir a bandeira que indica se o controlo é válido ou não.

HRESULT STDMETHODCALLTYPE getvalid(VARIANT_BOOL bValid);

Parâmetros

bVálido
VERDADE se o controlo for válido.

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

CStockPropImpl::p ut_Window

Este método chama CStockPropImpl::p ut_HWND, que devolve E_FAIL.

HRESULT STDMETHODCALLTYPE put_Window(LONG_PTR hWnd);

Parâmetros

hWnd
A maçaneta da janela.

Valor de retorno

Devolve E_FAIL.

Observações

A maçaneta da janela é um valor de apenas leitura.

CStockPropImpl::p utref_Font

Chame este método para definir as propriedades da fonte do controlo, com uma contagem de referências.

HRESULT STDMETHODCALLTYPE putref_Font(IFontDisp* pFont);

Parâmetros

pFont
Um apontador para as propriedades da fonte do controlo.

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

Observações

O mesmo que CStockPropImpl::p ut_Font, mas com uma contagem de referências.

CStockPropImpl::p utref_MouseIcon

Chame este método para definir as propriedades da imagem do gráfico (ícone, mapa de bits ou metaficheiro) para serem exibidas quando o rato estiver sobre o controlo, com uma contagem de referência.

HRESULT STDMETHODCALLTYPE putref_MouseIcon(IPictureDisp* pPicture);

Parâmetros

pImagem
Um apontador para as propriedades da imagem do gráfico.

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

Observações

O mesmo que CStockPropImpl::p ut_MouseIcon, mas com uma contagem de referências.

CStockPropImpl::p utref_Picture

Chame este método para definir as propriedades da imagem de um gráfico (ícone, bitmap ou metaficheiro) a serem exibidas, com uma contagem de referências.

HRESULT STDMETHODCALLTYPE putref_Picture(IPictureDisp* pPicture);

Parâmetros

pImagem
Um indicador das propriedades da imagem. Consulte IPictureDisp para mais detalhes.

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

Observações

O mesmo que CStockPropImpl::p ut_Picture, mas com uma contagem de referências.

Consulte também

Visão geral da classe
Classe IDispatchImpl