Controles ActiveX MFC: usando fontes
Se o controle ActiveX exibe o texto, você pode permitir que o usuário de controle modificar a aparência do texto modificação de uma propriedade da fonte. As propriedades da fonte são implementadas como objetos de fonte e pode ser um de dois tipos: estoque ou personalizada. As propriedades de estoque de fonte são as propriedades preimplemented de fonte que você pode adicionar usando o assistente para adicionar a propriedade. As propriedades da fonte personalizado não preimplemented e o desenvolvedor de controle determina o comportamento e o uso da propriedade.
Este artigo abrange os seguintes tópicos:
Usando a propriedade de estoque da fonte
Usando propriedades da fonte personalizado no seu controle
Usando a propriedade de estoque da fonte
As propriedades de estoque da fonte preimplemented pela classe COleControl. Além disso, uma página de propriedades de fonte padrão também está disponível, permitindo que o usuário altere vários atributos do objeto de fonte, como seu nome, tamanho e estilo.
Acessar o objeto de fonte GetFont, com SetFont, e as funções de InternalGetFont de COleControl. O usuário de controle de acesso no objeto de fonte de GetFont e SetFont funciona como qualquer outro obtém ou define a propriedade. Quando o acesso ao objeto da fonte é necessário dentro de um controle, use a função de InternalGetFont .
Como discutido em Controles ActiveX MFC: Propriedades, adicione as propriedades de estoque é fácil com Assistente de adição de propriedade. Você escolhe a propriedade da fonte, e o assistente da propriedade adicionar inserirá automaticamente a entrada de estoque da fonte da expedição do controle.
Para adicionar a propriedade de estoque da fonte usando o assistente para adicionar propriedade
Carregar o projeto do controle.
Na exibição da classe, expanda o nó da biblioteca do controle.
Clique com o botão direito do mouse no nó da interface para o controle (o segundo nó do nó da biblioteca) para abrir o menu de atalho.
No menu de atalho, clique Adicionar e clique em Adicionar Propriedade.
Isso abre o assistente de propriedade adicionar.
Na caixa de Nome da propriedade , clique Fonte.
Clique em Concluir.
O assistente da propriedade adicionar adiciona a seguinte linha no mapa da expedição de controle, localizado no arquivo de implementação da classe de controle:
DISP_STOCKPROP_FONT()
Além disso, o assistente da propriedade adicionar adiciona a seguinte linha no arquivo de controle .IDL:
[id(DISPID_FONT)] IFontDisp*Font;
A propriedade de estoque de legenda é um exemplo de uma propriedade de texto que possa ser desenhada usando as informações de estoque da propriedade da fonte. Adicione a propriedade de estoque da legenda para controlar usa as etapas semelhantes usadas para a propriedade de estoque da fonte.
Para adicionar a propriedade de estoque de legenda usando o assistente para adicionar propriedade
Carregar o projeto do controle.
Na exibição da classe, expanda o nó da biblioteca do controle.
Clique com o botão direito do mouse no nó da interface para o controle (o segundo nó do nó da biblioteca) para abrir o menu de atalho.
No menu de atalho, clique Adicionar e clique em Adicionar Propriedade.
Isso abre o assistente de propriedade adicionar.
Na caixa de Nome da propriedade , clique Legenda.
Clique em Concluir.
O assistente da propriedade adicionar adiciona a seguinte linha no mapa da expedição de controle, localizado no arquivo de implementação da classe de controle:
DISP_STOCKPROP_CAPTION()
Alterando a função de OnDraw
A implementação padrão de OnDraw usa a fonte do sistema do windows para todo o texto exibido no controle. Isso significa que você deve modificar o código de OnDraw selecionando o objeto de fonte no contexto do dispositivo. Para fazer isso, chame COleControl::SelectStockFont e passe o contexto do dispositivo de controle, conforme mostrado no seguinte exemplo:
CFont* pOldFont;
TEXTMETRIC tm;
const CString& strCaption = InternalGetText();
pOldFont = SelectStockFont(pdc);
pdc->FillRect(rcBounds, CBrush::FromHandle((HBRUSH )GetStockObject(WHITE_BRUSH)));
pdc->Ellipse(rcBounds);
pdc->GetTextMetrics(&tm);
pdc->SetTextAlign(TA_CENTER | TA_TOP);
pdc->ExtTextOut((rcBounds.left + rcBounds.right) / 2,
(rcBounds.top + rcBounds.bottom - tm.tmHeight) / 2,
ETO_CLIPPED, rcBounds, strCaption, strCaption.GetLength(), NULL);
pdc->SelectObject(pOldFont);
Depois que a função de OnDraw foi modificada para usar o objeto de fonte, todo o texto dentro do controle é exibido com as características da propriedade de fonte do estoque de controle.
Usando propriedades da fonte personalizado no seu controle
Além da propriedade de estoque da fonte, o controle ActiveX pode ter propriedades da fonte personalizado. Para adicionar uma propriedade de fonte personalizado você deve:
Use o assistente para adicionar a propriedade para implementar a propriedade da fonte personalizado.
Notificações da fonte de processamento.
Implementando uma nova interface de notificação da fonte.
Implementando uma propriedade de fonte personalizado
Para implementar uma propriedade de fonte personalizado, use o assistente da propriedade adicionar para adicionar a propriedade para e depois fazer algumas alterações no código. As seções a seguir descrevem como adicionar a propriedade personalizada de HeadingFont ao controle de exemplo.
Para adicionar a propriedade da fonte personalizado usando o assistente para adicionar propriedade
Carregar o projeto do controle.
Na exibição da classe, expanda o nó da biblioteca do controle.
Clique com o botão direito do mouse no nó da interface para o controle (o segundo nó do nó da biblioteca) para abrir o menu de atalho.
No menu de atalho, clique Adicionar e clique em Adicionar Propriedade.
Isso abre o assistente de propriedade adicionar.
Na caixa de Nome da propriedade , digite um nome para a propriedade. Para esse exemplo, use HeadingFont.
Para Tipo de Implementação, clique Get/Set Methods.
Na caixa de Tipo de propriedade , IDispatch* selecione para o tipo de propriedade.
Clique em Concluir.
O assistente da propriedade adicionar cria o código para adicionar a propriedade personalizada de HeadingFont à classe de CSampleCtrl e arquivo de SAMPLE.IDL. Como HeadingFont é do tipo de propriedade obter/cluster, o assistente da propriedade adicionar altera o mapa de expedição da classe de CSampleCtrl para incluir uma entrada macro de DISP_PROPERTY_EX_IDDISP_PROPERTY_EX :
DISP_PROPERTY_EX_ID(CMyAxFontCtrl, "HeadingFont", dispidHeadingFont,
GetHeadingFont, SetHeadingFont, VT_DISPATCH)
A macro de DISP_PROPERTY_EX associa o nome da propriedade de HeadingFont com sua classe correspondente de CSampleCtrl obtém e define métodos, GetHeadingFont e SetHeadingFont. O tipo do valor da propriedade também estiver especificado; nesse caso, VT_FONT.
O assistente para adicionar propriedade também adiciona uma declaração no arquivo de cabeçalho de controle (. H) para GetHeadingFont e SetHeadingFont funções e adiciona os modelos de função no arquivo de implementação de controle (.CPP):
IDispatch* CWizardGenCtrl::GetHeadingFont(void)
{
AFX_MANAGE_STATE(AfxGetStaticModuleState());
// TODO: Add your dispatch handler code here
return NULL;
}
void CWizardGenCtrl::SetHeadingFont(IDispatch* /*pVal*/)
{
AFX_MANAGE_STATE(AfxGetStaticModuleState());
// TODO: Add your property handler code here
SetModifiedFlag();
}
Finalmente, o assistente da propriedade adicionar modificar o arquivo de controle .IDL adicionando uma entrada para a propriedade de HeadingFont :
[id(1)] IDispatch* HeadingFont;
Alterações no código de controle
Agora que você adicionou a propriedade de HeadingFont ao controle, você deve fazer nenhuma alteração ao cabeçalho de controle e arquivos de implementação para oferecer suporte completo à nova propriedade.
No arquivo de cabeçalho de controle (. H), adicione a seguinte declaração de uma variável de membro protegido:
protected:
CFontHolder m_fontHeading;
No arquivo de implementação de controle (.CPP), faça o seguinte:
Inicializar m_fontHeading no construtor de controle.
CMyAxFontCtrl::CMyAxFontCtrl() : m_fontHeading(&m_xFontNotification) { InitializeIIDs(&IID_DNVC_MFC_AxFont, &IID_DNVC_MFC_AxFontEvents); }Declare uma estrutura de FONTDESC estático que contém atributos padrão da fonte.
static const FONTDESC _fontdescHeading = { sizeof(FONTDESC), OLESTR("MS Sans Serif"), FONTSIZE( 12 ), FW_BOLD, ANSI_CHARSET, FALSE, FALSE, FALSE };Na função de membro de DoPropExchange de controle, adicione uma chamada à função de PX_Font . Isso fornece a inicialização e a persistência da propriedade da fonte personalizado.
void CMyAxFontCtrl::DoPropExchange(CPropExchange* pPX) { ExchangeVersion(pPX, MAKELONG(_wVerMinor, _wVerMajor)); COleControl::DoPropExchange(pPX); // [...other PX_ function calls...] PX_Font(pPX, _T("HeadingFont"), m_fontHeading, &_fontdescHeading); }Concluir que implementa a função de membro de GetHeadingFont do controle.
IDispatch* CMyAxFontCtrl::GetHeadingFont(void) { AFX_MANAGE_STATE(AfxGetStaticModuleState()); return m_fontHeading.GetFontDispatch(); }Concluir que implementa a função de membro de SetHeadingFont do controle.
void CMyAxFontCtrl::SetHeadingFont(IDispatch* pVal) { AFX_MANAGE_STATE(AfxGetStaticModuleState()); m_fontHeading.InitializeFont(&_fontdescHeading, pVal); OnFontChanged(); //notify any changes SetModifiedFlag(); }Modifique a função de membro de OnDraw de controle para definir uma variável para manter a fonte selecionada anteriormente.
CFont* pOldHeadingFont;Modifique a função de membro de OnDraw de controle para selecionar a fonte personalizado no contexto do dispositivo adicionando a seguinte linha onde quer que a fonte deve ser usada.
pOldHeadingFont = SelectFontObject(pdc, m_fontHeading);Modifique a função de membro de OnDraw de controle para selecionar a fonte anterior de novo no contexto do dispositivo adicionando a seguinte linha depois que a fonte usada.
pdc->SelectObject(pOldHeadingFont);
Depois que a propriedade da fonte personalizado foi implementada, a página de propriedades de fonte padrão deve ser implementada, permitindo que os usuários alterem controle da fonte atual do controle. Para adicionar a ID da página de propriedades da página de propriedades de fonte padrão, insira a seguinte linha após a macro de BEGIN_PROPPAGEIDS :
PROPPAGEID(CLSID_CFontPropPage)
Você deve também incrementar o parâmetro de contagem de seu macro de BEGIN_PROPPAGEIDS por um. A linha a seguir ilustra esta:
BEGIN_PROPPAGEIDS(CMyAxFontCtrl, 2)
Depois que essas alterações, recrie o projeto inteiro inserir a funcionalidade adicional.
Notificações da fonte de processamento
Na maioria dos casos as necessidades de controle de saber quando as características do objeto da fonte foram alteradas. Cada objeto de fonte é capaz de fornecer notificações quando for alterada chamando uma função de membro da interface de IFontNotification , implementado por COleControl.
Se o controle usa a propriedade de estoque da fonte, as notificações são tratadas pela função de membro de OnFontChanged de COleControl. Quando você adiciona propriedades da fonte personalizado, você pode mandá-las usar a mesma implementação. No exemplo na seção anterior, isto era feito transmitindo &m_xFontNotification ao inicializar a variável de membro de m_fontHeading .
Implementando várias interfaces de objeto da fonte
.gif "Implementar várias interfaces de objeto de fonte")
As linhas sólidas na figura acima mostram que ambos os objetos da fonte estiverem usando a mesma implementação de IFontNotification. Isso pode causar problemas se você quisesse para distinguir que a fonte alterado.
Uma maneira de distinguir entre as notificações do objeto de fonte do controle é criar uma implementação da interface de IFontNotification separada para cada objeto de fonte no controle. Essa técnica permite que você no código de desenho atualizando somente a cadeia de caracteres, ou as cadeias de caracteres, que usam a fonte recentemente alterada. As seções a seguir demonstram as etapas necessárias para implementar interfaces separadas de notificação para uma segunda propriedade da fonte. A segunda propriedade da fonte é usada para ser a propriedade de HeadingFont que foi adicionada na seção anterior.
Implementando uma nova interface de notificação da fonte
Para distinguir as notificações de dois ou mais fontes, uma nova interface de notificação deve ser implementada para cada fonte usada no controle. As seções a seguir descrevem como implementar uma nova interface de notificação da fonte alterando o cabeçalho de controle e os arquivos de implementação.
Adições ao cabeçalho Arquivo
No arquivo de cabeçalho de controle (. H), adiciona as seguintes linhas à declaração de classe:
protected:
BEGIN_INTERFACE_PART(HeadingFontNotify, IPropertyNotifySink)
INIT_INTERFACE_PART(CMyAxFontCtrl, HeadingFontNotify)
STDMETHOD(OnRequestEdit)(DISPID);
STDMETHOD(OnChanged)(DISPID);
END_INTERFACE_PART(HeadingFontNotify)
Isso cria uma implementação da interface de IPropertyNotifySink chamada HeadingFontNotify. Essa nova interface contém um método chamado OnChanged.
Adições à implementação Arquivo
No código que inicializa a fonte do título (no construtor de controle), altere &m_xFontNotification a &m_xHeadingFontNotify. Adicione o seguinte código:
STDMETHODIMP_(ULONG) CMyAxFontCtrl::XHeadingFontNotify::AddRef()
{
METHOD_MANAGE_STATE(CMyAxFontCtrl, HeadingFontNotify)
return 1;
}
STDMETHODIMP_(ULONG) CMyAxFontCtrl::XHeadingFontNotify::Release()
{
METHOD_MANAGE_STATE(CMyAxFontCtrl, HeadingFontNotify)
return 0;
}
STDMETHODIMP CMyAxFontCtrl::XHeadingFontNotify::QueryInterface(REFIID iid, LPVOID FAR* ppvObj)
{
METHOD_MANAGE_STATE(CMyAxFontCtrl, HeadingFontNotify)
if( IsEqualIID(iid, IID_IUnknown) || IsEqualIID(iid, IID_IPropertyNotifySink))
{
*ppvObj= this;
AddRef();
return NOERROR;
}
return ResultFromScode(E_NOINTERFACE);
}
STDMETHODIMP CMyAxFontCtrl::XHeadingFontNotify::OnChanged(DISPID)
{
METHOD_MANAGE_STATE(CMyAxFontCtrl, HeadingFontNotify)
pThis->InvalidateControl();
return NOERROR;
}
STDMETHODIMP CMyAxFontCtrl::XHeadingFontNotify::OnRequestEdit(DISPID)
{
return NOERROR;
}
Os métodos de AddRef e de Release na interface de IPropertyNotifySink controlam a contagem de referência do objeto do controle ActiveX. Quando o controle obtém acesso ao ponteiro da interface, o controle AddRef chama para incrementar a contagem de referência. Quando o controle é concluído com o ponteiro, chama Release, da mesma forma que GlobalFree pode ser chamado para liberar um bloco de memória global. Quando a contagem de referência dessa interface vá para zero, a implementação da interface pode ser liberada. Neste exemplo, a função de QueryInterface retorna um ponteiro para uma interface de IPropertyNotifySink em um objeto específico. Esta função permite que um controle ActiveX consulta um objeto para determinar as interfaces da suporte.
Depois que essas alterações foram feitas ao seu projeto, recrie o projeto e use o contêiner de teste para testar a interface. Consulte Propriedades e eventos de teste com contêineres de teste para obter mais informações sobre como acessar o contêiner de teste.
Consulte também
Referência
Controles ActiveX MFC: usando imagens em um controle ActiveX
Controles ActiveX MFC: usando páginas de propriedade de estoque