Pular para o conteúdo principal
Visual Components são implementados no FRE para Windows.
O objeto ImageViewer é um controle ActiveX que permite visualizar e editar uma imagem e os blocos nela contidos. Uma imagem é conectada ao Image Viewer por meio da propriedade FRPage. O componente Image Viewer tem a seguinte aparência: ImageViewer 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 Visual Component para mais detalhes. As informações sobre a visualização e a edição da imagem são fornecidas por meio de interfaces de saída especiais. Essas interfaces são IImageViewerEvents (para C++) e a dispinterface DIImageViewerEvents (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 eventos, 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 dá suporte à interface IConnectionPointContainer. Para receber notificações de eventos, um usuário de C++ deve criar um objeto derivado da interface IImageViewerEvents e, em seguida, configurar a conexão entre ele e a origem dos eventos implementada no objeto ImageViewer por meios COM padrão. O componente Image Viewer pode ser conectado ao componente Component Synchronizer; nesse caso, todos os eventos do Image Viewer serão transmitidos automaticamente aos outros componentes conectados ao Synchronizer, e todo o aplicativo funcionará de forma síncrona.

Properties

Especifica a ferramenta ativa para edição de blocos e imagens.

Especifica se o Image Viewer deve rolar por todas as páginas do documento. Se esta propriedade for FALSE, o Image Viewer rola apenas pela página selecionada.

Por padrão, o valor é TRUE.

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

Por padrão, o valor é TRUE.

Especifica se o painel de legenda do Image 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 Image Viewer está habilitado. Se esta propriedade for FALSE, o menu de contexto nunca será exibido.

Por padrão, o valor é TRUE.

,read-only

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

Especifica a página do documento conectada ao Image Viewer.

Especifica se os fragmentos reconhecidos devem ser destacados na imagem durante o reconhecimento. Esta propriedade permite acompanhar o progresso do reconhecimento.

Por padrão, o valor é TRUE.

Especifica se o Image Viewer está bloqueado.

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

  • uma operação de análise, reconhecimento, síntese ou exportação é chamada a partir da API do FineReader Engine (e não dos Visual Components), ou
  • sua aplicação 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 defini-la como FALSE após o término da operação. Dessa forma, o documento não poderá ser corrompido pelo Image Viewer.

Por padrão, o valor é FALSE.

,read-only

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

Especifica os parâmetros de processamento padrão para um documento. Esses parâmetros são usados quando os processos de análise, reconhecimento e síntese são chamados diretamente do Image Viewer.

Se o Image Viewer estiver conectado ao Component Synchronizer, use a propriedadeIComponentSynchronizer::ProcessingParamspara alterar os parâmetros usados no processamento. Se você alterar os parâmetros de processamento por meio da propriedade do Image Viewer, podem ocorrer erros.

Fornece acesso à coleção de índices das páginas selecionadas na caixa de diálogo Image Editor.

Especifica o caminho para a pasta que contém os arquivos com as configurações do Image Viewer. 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 é apasta de dados do FineReader Engine. Ela pode ser alterada durante a inicialização do FineReader Engine. 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.

Especifica o título do componente Image Viewer.

Por padrão, é “Image”.

,read-only

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

Especifica a escala da imagem em pontos percentuais. Esta propriedade também pode ser definida como uma das constantes.

Por padrão, o valor é ST_BestFit, o que significa que o melhor ajuste é selecionado automaticamente.

,read-only

Armazena as coordenadas da área visível do documento em pixels. As coordenadas são relativas à imagem do documento.

, somente leitura

Retorna o handle de janela da área do cliente.

Armazena as coordenadas do retângulo da área de zoom em pixels. As coordenadas são relativas à imagem do documento.

Especifica se a área de zoom deve ser marcada na imagem com um retângulo pontilhado.

Por padrão, o valor é TRUE.

Métodos

NomeDescrição
CenterOnDocumentPointRola a visualização da imagem para que o ponto especificado fique no centro da exibição.
DocumentToScreenConverte as coordenadas do ponto especificado na imagem do documento em coordenadas de tela.
GetSelectedBlocksIndicesRetorna a coleção de índices dos blocos selecionados.
GetSelectedCellsRetorna o retângulo delimitador das células selecionadas no bloco de tabela especificado.
PrintImprime a imagem.
ScreenToDocumentConverte as coordenadas de tela do ponto especificado em coordenadas na imagem do documento.
SetSelectedBlocksIndicesDefine a seleção de blocos.
SetSelectedCellsDefine as células selecionadas do bloco de tabela especificado.
ShowDocumentAreaRola a visualização da imagem para que a área do documento com as coordenadas especificadas fique visível (na medida do possível).
UpdateOptionsAtualiza as configurações especificadas na caixa de diálogo Opções do Image Viewer. Talvez seja necessário chamar este método se as opções tiverem sido alteradas em algum outro Visual Component, para atualizar as opções do Image Viewer para o estado atual.

Exemplos

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

Veja também

IImageViewerEvents IComponentSynchronizer::ImageViewer Criando um aplicativo com interface gráfica do usuário Personalizando o menu de contexto e a barra de ferramentas de um Visual Component Trabalhando com Properties