Controles ActiveX do MFC: Tópicos Avançados

Este artigo aborda tópicos avançados relacionados ao desenvolvimento de controles ActiveX. Elas incluem:

• Usando classes de banco de dados em controles ActiveX

• Implementando uma propriedade parametrizada

• Manipulando erros no controle ActiveX

• Manipulando chaves especiais no controle

• Acessando controles de caixa de diálogo que são invisíveis em tempo de execução

Usando classes de banco de dados em controles ActiveX

Como as classes de controle ActiveX fazem parte da biblioteca de classes, você pode aplicar os mesmos procedimentos e regras para usar classes de banco de dados em um aplicativo MFC padrão para desenvolver controles ActiveX que usam as classes de banco de dados MFC.

Para obter uma visão geral das classes de banco de dados MFC, consulte classes de banco de dados MFC (DAO e ODBC). O artigo apresenta as classes ODBC do MFC e as classes MFC DAO e direciona você para mais detalhes sobre qualquer uma delas.

Implementando uma propriedade parametrizada

Uma propriedade parametrizada (às vezes chamada de matriz de propriedades) é um método para expor uma coleção homogênea de valores como uma única propriedade do controle. Por exemplo, você pode usar uma propriedade parametrizada para expor uma matriz ou um dicionário como uma propriedade. No Visual Basic, essa propriedade é acessada usando a notação de matriz:

x = o.Array(2, 3) ' gets element of 2D array
o.Array(2, 3) = 7 ' sets element of 2D array

Use o Assistente para Adicionar Propriedade para implementar uma propriedade parametrizada. O Assistente para Adicionar Propriedade implementa a propriedade adicionando um par de funções Get/Set que permitem ao usuário de controle acessar a propriedade usando a notação acima ou da maneira padrão.

Semelhante a métodos e propriedades, as propriedades parametrizadas também têm um limite para o número de parâmetros permitido. No caso de propriedades parametrizadas, o limite é de 15 parâmetros (com um parâmetro reservado para armazenar o valor da propriedade).

O procedimento a seguir adiciona uma propriedade parametrizada chamada Array, que pode ser acessada como uma matriz bidimensional de inteiros.

Para adicionar uma propriedade parametrizada usando o Assistente para Adicionar Propriedade

1. Carregue o projeto do controle.

2. No Modo de Exibição de Classe, expanda o nó de biblioteca do controle.

3. Clique com o botão direito do mouse no nó de interface do seu controle (o segundo nó do nó da biblioteca) para abrir o menu de atalho.

4. No menu de atalho, clique em Adicionar e clique em Adicionar Propriedade.

5. Na caixa Nome da Propriedade , digite Array.

6. Na caixa Tipo de Propriedade , selecione short.

7. Para o Tipo de Implementação , clique em Obter/Definir Métodos.

8. Nas caixas Obter Função e Definir Função, digite nomes exclusivos para suas funções Get e Set ou aceite os nomes padrão.

9. Adicione um parâmetro, chamado linha (tipo curto), usando os controles Nome do Parâmetro e Tipo de Parâmetro .

10. Adicione um segundo parâmetro chamado coluna (tipo curto).

11. Clique em Concluir.

Alterações feitas pelo Assistente para Adicionar Propriedade

Quando você adiciona uma propriedade personalizada, o Assistente para Adicionar Propriedade faz alterações no cabeçalho da classe de controle (. H) e a implementação (. Arquivos CPP).

As linhas a seguir são adicionadas à classe de controle. Arquivo H:

SHORT GetArray(SHORT row, SHORT column);
void SetArray(SHORT row, SHORT column, SHORT newVal);

Esse código declara duas funções chamadas GetArray e SetArray que permitem que o usuário solicite uma linha e coluna específicas ao acessar a propriedade.

Além disso, o Assistente para Adicionar Propriedade adiciona as seguintes linhas ao mapa de expedição de controle, localizado na implementação da classe de controle (. Arquivo CPP):

DISP_PROPERTY_PARAM_ID(CMyAxUICtrl, "Array", dispidArray, GetArray, SetArray, VT_I2, VTS_I2 VTS_I2)

Por fim, as implementações do e SetArray das GetArray funções são adicionadas ao final do . Arquivo CPP. Na maioria dos casos, você modificará a função Get para retornar o valor da propriedade. A função Set geralmente conterá o código que deve ser executado antes ou depois das alterações da propriedade.

Para que essa propriedade seja útil, você pode declarar uma variável de membro de matriz bidimensional na classe de controle, do tipo short, para armazenar valores para a propriedade parametrizada. Em seguida, você pode modificar a função Get para retornar o valor armazenado na linha e coluna adequadas, conforme indicado pelos parâmetros, e modificar a função Set para atualizar o valor referenciado pelos parâmetros de linha e coluna.

Manipulando erros no controle ActiveX

Se ocorrerem condições de erro no controle, talvez seja necessário relatar o erro ao contêiner de controle. Há dois métodos para relatar erros, dependendo da situação em que o erro ocorre. Se o erro ocorrer dentro da função Get ou Set de uma propriedade ou dentro da implementação de um método de Automação OLE, o controle deverá chamar COleControl::ThrowError, que sinaliza para o usuário de controle que ocorreu um erro. Se o erro ocorrer em qualquer outro momento, o controle deverá chamar COleControl::FireError, que aciona um evento de erro de estoque.

Para indicar o tipo de erro que ocorreu, o controle deve passar um código de erro para ThrowError ou FireError. Um código de erro é um código de status OLE, que tem um valor de 32 bits. Quando possível, escolha um código de erro no conjunto padrão de códigos definidos no OLECTL. Arquivo de cabeçalho H. A tabela a seguir resume esses códigos.

Códigos de erro de controle ActiveX

Se necessário, use a macro CUSTOM_CTL_SCODE para definir um código de erro personalizado para uma condição que não seja coberta por um dos códigos padrão. O parâmetro para essa macro deve ser um inteiro entre 1000 e 32767, inclusive. Por exemplo:

#define MYCTL_E_SPECIALERROR CUSTOM_CTL_SCODE(1000)

Se você estiver criando um controle ActiveX para substituir um controle VBX existente, defina seus códigos de erro de controle ActiveX com os mesmos valores numéricos que o controle VBX usa para garantir que os códigos de erro sejam compatíveis.

Manipulando chaves especiais no controle

Em alguns casos, talvez você queira lidar com determinadas combinações de pressionamento de tecla de uma maneira especial; por exemplo, insira uma nova linha quando a tecla ENTER for pressionada em um controle de caixa de texto de várias linhas ou mover-se entre um grupo de controles de edição quando uma ID de tecla direcional for pressionada.

Se a classe base do controle ActiveX for COleControl, você poderá substituir CWnd::P reTranslateMessage para manipular mensagens antes que o contêiner as processe. Ao usar essa técnica, sempre retorne TRUE se você manipular a mensagem em sua substituição de PreTranslateMessage.

O exemplo de código a seguir demonstra uma possível maneira de lidar com mensagens relacionadas às chaves direcionais.

BOOL CMyAxUICtrl::PreTranslateMessage(MSG* pMsg)
{
   BOOL bHandleNow = FALSE;

   switch (pMsg->message)
   {
   case WM_KEYDOWN:
      switch (pMsg->wParam)
      {
      case VK_UP:
      case VK_DOWN:
      case VK_LEFT:
      case VK_RIGHT:
         bHandleNow = TRUE;
         break;
      }
      if (bHandleNow)
      {
         OnKeyDown((UINT)pMsg->wParam, LOWORD(pMsg->lParam), HIWORD(pMsg->lParam));
      }
      break;
   }
   return bHandleNow;
}

Para obter mais informações sobre como lidar com interfaces de teclado para um controle ActiveX, consulte a documentação do SDK do ActiveX.

Acessando controles de caixa de diálogo que são invisíveis em tempo de execução

Você pode criar controles de caixa de diálogo que não têm interface do usuário e são invisíveis em tempo de execução. Se você adicionar um controle ActiveX invisível em tempo de execução a uma caixa de diálogo e usar CWnd::GetDlgItem para acessar o controle, o controle não funcionará corretamente. Em vez disso, você deve usar uma das seguintes técnicas para obter um objeto que represente o controle:

• Usando o Assistente para Adicionar Variável de Membro, selecione Variável de Controle e selecione a ID do controle. Insira um nome de variável membro e selecione a classe wrapper do controle como o Tipo de Controle.

  - ou -

• Declare uma variável local e uma subclasse como o item de diálogo. Insira o código que se assemelha ao seguinte (CMyCtrl é a classe wrapper, IDC_MYCTRL1 é a ID do controle):

  CCirc myCirc;
  myCirc.SubclassDlgItem(IDC_CIRCCTRL2, this);
  // ... use myCirc ...
  myCirc.UnsubclassWindow();
  

Consulte também

Controles MFC ActiveX