Pular para o conteúdo principal
O Visual Components é implementado no FRE para Windows.
O objeto TextValidator é um controle ActiveX que permite verificar caracteres reconhecidos com incerteza em um documento. O documento é conectado ao componente por meio da propriedade FRDocument. O componente Text Validator pode ter esta aparência: TextValidator Para textos com direção de escrita vertical:
TextValidator_CJK
Para iniciar a verificação ortográfica, chame o método Spell ou SpellBlock do objeto TextValidator. Se a verificação ortográfica já estiver em andamento, primeiro será necessário interrompê-la; caso contrário, novas chamadas desses métodos serão ignoradas.
  • Você também pode iniciar a verificação ortográfica usando o botão Verificar ortografia no Text Editor.
  • Alguns caracteres de idiomas com sistemas de escrita complexos (por exemplo, chinês, tailandês, armênio) podem não ser exibidos no Text Validator se a fonte usada nele não incluir os caracteres correspondentes. Nesse caso, você pode especificar outra fonte na caixa de diálogo Opções (no Text Validator, clique em Configurações > Opções, vá para a guia Exibir e selecione a fonte na lista suspensa Fonte usada para exibir texto simples).
As informações sobre a verificação ortográfica são fornecidas por meio de interfaces de saída especiais. Essas interfaces são ITextValidatorEvents (para C++) e a dispinterface DITextValidatorEvents (para Visual Basic). Vale observar que os usuários do Visual Basic não precisam se preocupar com os detalhes de implementação das interfaces de evento, pois essa plataforma de desenvolvimento oferece meios simples de lidar com elas. Esse objeto pode ser declarado com WithEvents no Visual Basic. Para usuários de C++, isso significa que ele oferece suporte à interface IConnectionPointContainer. Para receber eventos de notificação, o usuário de C++ deve criar um objeto derivado da interface ITextValidatorEvents e, em seguida, configurar a conexão entre ele e a origem dos eventos implementada no objeto TextValidator usando meios COM padrão. O componente Text Validator pode ser conectado ao componente Component Synchronizer; nesse caso, todos os eventos do Text Validator serão transmitidos automaticamente para outros componentes conectados ao Synchronizer, e todo o aplicativo funcionará de forma síncrona.

Properties

,somente leitura

Representa uma coleção de palavras adicionadas a um dicionário por um usuário durante a verificação ortográfica.

Se palavras forem adicionadas a um dicionário durante a verificação ortográfica, o dicionário do usuário será criado na pasta especificada pela propriedadeILanguageDatabase::DictionaryExtensionsPath.

Representa uma coleção de pares de palavras. A primeira palavra do par é a palavra de origem substituída automaticamente durante a verificação ortográfica; a segunda é a substituta.

Especifica se o Text Validator deve corrigir espaços durante a verificação ortográfica. Se o valor desta propriedade for definido como TRUE, o Text Validator corrigirá espaços antes ou depois de sinais de pontuação.

Por padrão, o valor é FALSE.

Representa uma coleção de palavras que devem ser ignoradas durante a verificação ortográfica.

, somente leitura

Especifica se a verificação ortográfica está em andamento.

Representa o documento conectado ao Text Validator.

Especifica se o Text Validator está bloqueado.

Esta propriedade é útil nas seguintes situações:

  • uma operação de análise, reconhecimento, síntese ou exportação é chamada pela API do FineReader Engine (e não pelos Visual Components), ou
  • seu aplicativo recebe notificações de determinados eventos (por exemplo, do objeto) e processa mensagens do Windows provenientes dos Visual Components nesses manipuladores de eventos.

Nesse caso, recomendamos definir esta propriedade como TRUE antes da análise, reconhecimento, síntese ou exportação, e como FALSE após o término da operação. Dessa forma, o documento não poderá ser corrompido pelo Text Validator.

Por padrão, o valor é FALSE.

Representa uma coleção de pares de palavras. A primeira palavra do par é a palavra de origem substituída durante a verificação ortográfica; a segunda é a substituta.

Especifica o caminho para a pasta que contém os arquivos com as configurações do Text Validator. Os demais Visual Components possuem a mesma propriedade. Cada Visual Component deve usar sua própria pasta de configurações.

O valor desta propriedade é composto pelo caminho para a pasta na qual o ABBYY FineReader Engine armazena dados específicos do usuário e pelo nome de sua subpasta. Por padrão, a pasta com dados específicos do usuário é aFineReader Engine data folder. Ela pode ser alterada durante a inicialização do FineReader Engine (por meio defunção, ou por meio dométodo). O nome padrão da subpasta é um GUID arbitrário. Para alterar o nome da subpasta, você deve especificar o novo nome nas propriedades do componente no Visual Studio, em tempo de design. Se você tentar especificar o valor da propriedade em tempo de execução, esse valor será ignorado.

Se você adicionar o componente a um formulário no Visual Studio em tempo de design, o valor da propriedade será definido automaticamente com o valor padrão ou manualmente com um valor personalizado. Em ambos os casos, o valor é definido em tempo de design. Se, por algum motivo, o valor da propriedade não for definido em tempo de design (por exemplo, se você gerar o componente dinamicamente em tempo de execução), o componente criará uma nova pasta com as configurações sempre que for inicializado. Para evitar a multiplicação de pastas, você deve excluir a pasta de configurações criada após a desinicialização do componente. Nesse caso, você poderá usar apenas as configurações padrão do componente e não poderá salvar as configurações entre as sessões.

Especifica se o Text Validator deve parar em palavras compostas durante a verificação ortográfica.

Por padrão, o valor é FALSE.

Especifica se o Text Validator deve parar em ruído durante a verificação ortográfica. Ruído é uma combinação de caracteres sem sentido.

Por padrão, o valor é FALSE.

Especifica se o Text Validator deve parar nas palavras que não forem encontradas no dicionário durante a verificação ortográfica. Esta propriedade e a propriedade StopAtUncertain não podem ser definidas como FALSE simultaneamente.

Por padrão, o valor é TRUE.

Especifica se o Text Validator deve parar em caracteres reconhecidos de forma incerta durante a verificação ortográfica. Esta propriedade e a propriedade StopAtNonDictionary não podem ser definidas como FALSE simultaneamente.

Por padrão, o valor é TRUE.

,somente leitura

Representa uma coleção de palavras sugeridas para corrigir a grafia de palavras reconhecidas de forma incerta durante a verificação ortográfica.

Especifica os parâmetros padrão de síntese de um documento. Esses parâmetros são usados se o Text Validator precisar realizar a síntese do documento (isso pode acontecer se a estrutura lógica de um documento se tornar incorreta devido a algumas operações de edição).

Se o Text Validator estiver conectado ao Component Synchronizer, use a propriedadeIComponentSynchronizer::ProcessingParamspara alterar os parâmetros usados na síntese do documento. Se você alterar esses parâmetros por meio da propriedade do Text Validator, poderão ocorrer erros.

,somente leitura

Representa a posição de um caractere incerto ou de uma palavra incerta.

, somente leitura

Retorna o handle da janela da área do cliente.

Métodos

NomeDescrição
EndSpellingInterrompe a verificação ortográfica.
SpellInicia a verificação ortográfica a partir da posição especificada.
SpellBlockVerifica a ortografia do bloco especificado.
UpdateOptionsAtualiza as configurações especificadas na caixa de diálogo Opções do Text Validator. Talvez seja necessário chamar esse método caso as opções tenham sido alteradas em outro Visual Component, para sincronizá-las com o estado atual.

Exemplos

Este componente é usado nos seguintes exemplos de código: VisualComponents.

Veja também

ITextValidatorEvents IComponentSynchronizer::TextValidator Criando um aplicativo com interface gráfica do usuário