Pular para o conteúdo principal
Visual Components são implementados no FRE para Windows.
O objeto ZoomViewer é um controle ActiveX que permite visualizar uma imagem ampliada da linha ou da área da imagem processada que está sendo editada no momento. Enquanto o Image Viewer exibe a visão geral da página, o Zoom Viewer oferece uma maneira prática de ver a imagem em mais detalhes, ajustar a posição da área ou comparar caracteres duvidosos com a imagem ampliada. Uma imagem é conectada ao Zoom Viewer por meio da propriedade FRPage. O componente Zoom Viewer tem a seguinte aparência: ZoomViewer Você pode modificar a aparência do componente por meio de suas propriedades. Por exemplo, pode modificar o menu de contexto do componente por meio da propriedade Commands. Consulte Customizing the Context Menu and Toolbar of a Visual Component para mais detalhes. As informações sobre a visualização de uma imagem são fornecidas por meio de interfaces de saída especiais. Essas interfaces são IZoomViewerEvents (para C++) e uma dispinterface DIZoomViewerEvents (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 meios 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, um usuário de C++ deve criar um objeto derivado da interface IZoomViewerEvents e, em seguida, configurar a conexão entre ele e a origem dos eventos implementada no objeto ZoomViewer usando os meios padrão do COM. O componente Zoom Viewer pode ser conectado ao componente Component Synchronizer. Nesse caso, todos os eventos do Zoom Viewer serão transmitidos automaticamente para 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 painel inferior do Zoom Viewer está habilitado. Se esta propriedade for FALSE, o painel inferior não será exibido.

Por padrão, o valor é TRUE.

Especifica se o menu de contexto do Zoom 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 Zoom Viewer. Consultea lista de comandos disponíveis no Zoom Viewer.

Representa a página do documento conectada ao Zoom Viewer.

Especifica se o Zoom 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
  • 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. Assim, o documento não poderá ser corrompido pelo Zoom Viewer.

Por padrão, o valor é FALSE.

Especifica os parâmetros de processamento padrão para o documento. Esses parâmetros são utilizados quando os processos de análise e reconhecimento são chamados diretamente do Zoom Viewer.

Se o Zoom Viewer estiver conectado ao Component Synchronizer, utilize a propriedadeIComponentSynchronizer::ProcessingParamspara alterar os parâmetros usados no processamento. Se os parâmetros de processamento forem alterados por meio da propriedade do Zoom Viewer, podem ocorrer erros.

Especifica o caminho para a pasta que contém os arquivos com as configurações do Zoom Viewer. Os demais Visual Components possuem a mesma propriedade. Cada Visual Component deve utilizar 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 (por meio da funçãoou do método). O nome padrão da subpasta é um GUID arbitrário. Para alterar o nome da subpasta, especifique o novo nome em the properties of the component in Visual Studio at design time. If you try to specify the value of the property at run time, this value is ignored.

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 estiver 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 toda vez que for inicializado. Para evitar a proliferação de pastas, você deve excluir a pasta de configurações criada após a desinicialização do componente. Nesse caso, será possível usar apenas as configurações padrão do componente, sem a possibilidade de salvar as configurações entre sessões.

Stores the coordinates of the current character rectangle in pixels. The coordinates are relative to the document image.

Specifies whether the current character should be marked with a yellow rectangle.

By default, the value is TRUE.

Specifies the scale of the image in percentage points. This property can be also set to one of theconstants.

By default, the value is ST_PixelToPixel, which means that the image is displayed in the pixel-to-pixel mode.

,read-only

Stores the coordinates of the visible document area in pixels. The coordinates are relative to the document image.

, read-only

Returns the window handle of the client area.

Métodos

NomeDescrição
CenterOnDocumentPointDesloca a visualização com zoom 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.
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.
ShowDocumentAreaDesloca a visualização com zoom 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 Zoom Viewer. Talvez seja necessário chamar esse método se as opções tiverem sido alteradas em algum outro Componente Visual, para atualizar as opções do Zoom Viewer para o estado atual.

Exemplos

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

Veja também

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