Pular para o conteúdo principal
Os Componentes Visuais são implementados no FRE para Windows.
O objeto DocumentViewer é um controle ActiveX que permite visualizar a lista de páginas do documento e monitorar seu estado. Você também pode salvar o documento reconhecido ou abri-lo no aplicativo selecionado usando os comandos disponíveis no componente. Um documento é conectado ao componente por meio da propriedade FRDocument. O componente Document Viewer pode ter a seguinte aparência, dependendo do valor da propriedade Mode:
  • Visualização detalhada
Fornece informações detalhadas sobre cada página do documento. DocumentViewer_Details
  • Visualização em miniaturas
Exibe as páginas do documento como miniaturas. DocumentViewer_Thumbnails Você pode modificar a aparência do componente por meio de suas propriedades. Por exemplo, pode adicionar botões à barra de ferramentas e removê-los por meio da propriedade Toolbar, ou modificar o menu de contexto do componente por meio da propriedade PopupMenu. Consulte Personalizando o menu de contexto e a barra de ferramentas de um componente visual para mais detalhes. As informações de monitoramento do documento são fornecidas por meio de interfaces de saída especiais. Essas interfaces são IDocumentViewerEvents (para C++) e a dispinterface DIDocumentViewerEvents (para Visual Basic). Vale observar que os usuários do Visual Basic não precisam se preocupar com os detalhes da implementação das interfaces de evento, pois essa plataforma de desenvolvimento oferece recursos simples para lidar com elas. Esse objeto pode ser declarado com WithEvents no Visual Basic. Para o usuário de C++, isso significa que ele oferece suporte à interface IConnectionPointContainer. Para receber notificações de eventos, o usuário de C++ deve criar um objeto derivado da interface IDocumentViewerEvents e, em seguida, configurar a conexão entre ele e a fonte de eventos implementada no objeto DocumentViewer usando os mecanismos padrão do COM. O componente Document Viewer pode ser conectado ao componente Component Synchronizer. Nesse caso, todos os eventos do Document Viewer serão transmitidos automaticamente para outros componentes conectados ao Synchronizer, e todo o aplicativo funcionará de forma síncrona.

​
Properties

Especifica a página ativa no Document Viewer. Se não houver página ativa, o valor desta propriedade é 0.

Especifica se o painel de legenda do Document Viewer está habilitado. Se esta propriedade for FALSE, o painel de legenda não será exibido.

Por padrão, o valor é TRUE.

Especifica se o menu de contexto do Document Viewer está habilitado. Se esta propriedade for FALSE, o menu de contexto nunca será exibido.

Por padrão, o valor é TRUE.

,somente leitura

Fornece acesso aos comandos disponíveis no Document Viewer. Consultea lista de comandos disponíveis no Document Viewer.

Especifica o documento conectado ao Document Viewer.

Especifica se a página de idioma do Document Viewer está habilitada. Se esta propriedade for FALSE, a página de idioma não será exibida.

Por padrão, o valor é TRUE.

Especifica se o Document Viewer 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
  • your application receives notifications of certain events (e.g., from theobject) e processa mensagens do Windows provenientes dos Visual Components nos manipuladores desses eventos.

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

Por padrão, o valor é FALSE.

Especifica o modo atual do Document Viewer: visualização em Detalhes ou em Miniaturas.

Por padrão, o modo é DVM_Thumbnails.

,somente leitura

Fornece acesso às configurações do menu de contexto.

Especifica os parâmetros de processamento padrão para o documento. Esses os parâmetros são usados se os processos de análise e reconhecimento forem chamados diretamente do Document Viewer.

Se o Document Viewer estiver conectado ao Component Synchronizer, use aIComponentSynchronizer::ProcessingParamspropriedade para alterar os parâmetros usados no processamento. Se você alterar os parâmetros de processamento por meio da propriedade do Document Viewer, podem ocorrer erros.

Especifica o título do componente Document Viewer.

Por padrão, é “Pages”.

,read-only

Fornece acesso às configurações da barra de ferramentas.

Fornece acesso à coleção de índices das páginas selecionadas.

Especifica o caminho para a pasta que contém os arquivos com as configurações do Document Viewer. Outros 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 dafunção, ou por meio dométodo). O nome padrão da subpasta é um GUID arbitrário. Para alterar o nome da subpasta, especifique 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 durante o 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 o componente for gerado dinamicamente em tempo de execução), o componente criará uma nova pasta com as configurações a cada inicialização. Para evitar a proliferação de pastas, exclua a pasta de configurações criada após a desinicialização do componente. Nesse caso, somente as configurações padrão do componente estarão disponíveis e não será possível salvar as configurações entre sessões.

, somente leitura

Retorna o identificador de janela da área do cliente.

​
Métodos

NomeDescrição
UpdateOptionsAtualiza as configurações especificadas na caixa de diálogo Opções do Document Viewer. Talvez seja necessário chamar esse método se as opções tiverem sido alteradas em outro componente visual, para atualizar as opções do Document Viewer de acordo com o estado atual.

​
Exemplos

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

​
Veja também

IDocumentViewerEvents IComponentSynchronizer::DocumentViewer Criando um aplicativo com interface gráfica do usuário Personalizando o menu de contexto e a barra de ferramentas de um componente visual