Controles ActiveX MFC: Tópicos avançados

Este artigo aborda tópicos avançados relacionados ao desenvolvimento de controles ActiveX. Estes são, entre outros:

• Usando classes de banco de dados em controles ActiveX

• Implementando uma propriedade parametrizada

• Manipulando erros em seu controle ActiveX

• Manuseamento de teclas especiais no comando

• Aceder a controlos 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 do 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 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 de Adição de Propriedades para implementar uma propriedade parametrizada. O Assistente para Adicionar Propriedade implementa a propriedade adicionando um par de funções Get/set que permitem que o usuário de controle acesse a propriedade usando a notação acima ou da maneira padrão.

Semelhante aos métodos e propriedades, as propriedades parametrizadas também têm um limite para o número de parâmetros permitidos. 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 seu controlador.

2. Na Vista de Classe, expanda o nó da biblioteca do seu controle.

3. Clique com o botão direito do mouse no nó da 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, em seguida, clique em Adicionar propriedade.

5. Na caixa Nome da propriedade , digite Array.

6. Na caixa Tipo de propriedade , selecione short.

7. Para Tipo de implementação, clique em Obter/definir métodos.

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

9. Adicione um parâmetro, chamado row (type short), usando os controles Parameter Name e Parameter Type .

10. Adicione um segundo parâmetro chamado coluna (digite short).

11. Clique em Concluir.

Alterações feitas pelo Assistente de Adição de Propriedades

Quando adiciona uma propriedade personalizada, o Assistente para Adicionar Propriedade faz alterações nos ficheiros de cabeçalho da classe de controlo (.H) e nos ficheiros de implementação (.CPP).

As seguintes linhas são adicionadas ao ficheiro da classe de controlo .H:

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

Este código declara duas funções chamadas GetArray e SetArray que permitem ao usuário solicitar 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 distribuição de controle, localizado na implementação da classe de controle (.CPP):

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

Finalmente, as implementações das funções GetArray e SetArray 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á código que deve ser executado, antes ou depois das alterações de 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 apropriadas, conforme indicado pelos parâmetros, e modificar a função set para atualizar o valor referenciado pelos parâmetros de linha e coluna.

Tratando erros no seu controle ActiveX

Se ocorrerem condições de erro no controle, talvez seja necessário relatar o erro para o contêiner de controle. Existem 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 deve chamar COleControl::ThrowError, que sinaliza ao usuário de controle que ocorreu um erro. Se o erro ocorrer em qualquer outro momento, o controle deve chamar COleControl::FireError, que aciona um evento de erro padrão.

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. Sempre que possível, escolha um código de erro do conjunto padrão de códigos definido no ficheiro de cabeçalho OLECTL.H. A tabela a seguir resume esses códigos.

Códigos de erro do 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 é coberta por um dos códigos padrão. O parâmetro para esta 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.

Manuseamento de teclas especiais no comando

Em alguns casos, você pode querer lidar com certas 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 mova-se entre um grupo de controles de edição quando um ID de tecla direcional for pressionado.

Se a classe base do seu controlo ActiveX for COleControl, poderá sobrepor CWnd::PreTranslateMessage para manipular mensagens antes que o contentor 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 maneira possível de manipular quaisquer 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 manipular 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 diálogo que não têm interface de 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 representa o controle:

• Usando o Assistente para Adicionar Variável de Membro, selecione Variável de Controle e, em seguida, selecione a ID do controle. Insira um nome de variável de 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 um código semelhante ao seguinte (CMyCtrl é a classe wrapper IDC_MYCTRL1 é a ID do controle):

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

Ver também

Controles ActiveX MFC