Document viewer

Propriedades de controle e configuração do Visualizador de documentos para renderizar PDFs e imagens em linha a partir de buckets de armazenamento, entidades ou URLs públicos.

Use o controle Visualizador de documentos para renderizar um documento e exibi-lo embutido em seu aplicativo. Por exemplo, você pode usar o controle Visualizador de documentos para exibir um documento de fatura ou um recibo que pode estar localizado em várias fontes, como buckets de armazenamento, entidades ou links públicos.

O controle Visualizador de documentos não é compatível com arquivos na máquina local. Você deve fazer referência a documentos remotos usando um URL, um bucket de armazenamento ou uma entidade.

Ao atribuir o arquivo a uma variável do aplicativo, certifique-se de que a variável seja do tipo IResource.

Se você quiser apenas exibir uma imagem, é recomendável usar o controle Imagem .

Importante:

O Visualizador de documentos usa um visualizador PDF.js integrado, que funciona de forma consistente em todos os navegadores. Nenhuma configuração do navegador é necessária. Ao carregar PDFs de servidores de arquivos externos, o servidor deve ser compatível com solicitações de origem cruzada. Se o CORS não estiver habilitado, o visualizador PDF.js integrado não poderá renderizar o documento.

Usando o Visualizador de documentos com um bucket de armazenamento

Se você estiver trabalhando com um bucket de armazenamento em seu aplicativo, a propriedade Origem de um controle Visualizador de documentos deve ser uma variável IResource :

1. Adicione uma regra de Download do bucket de armazenamento ao seu aplicativo.
2. Associe uma variável IResource à regra de Download do bucket de armazenamento .
3. Vincule a mesma variável IResource à propriedade Origem do Visualizador de documentos.

Trabalhando com o IResource

Se você obter um arquivo como um ILocalResource, ele será convertido automaticamente em um IResource usando:

JobAttachment.fromResource(file) // file is a ILocalResource

Importante:

As seguintes funções foram descontinuadas e não devem mais ser usadas:

• .toLocalResource
• .toAppsFile

Navegação de Página

Você pode navegar programaticamente até uma página específica dentro do Visualizador de documentos usando:

appsFile.NavigateToPage(pageNumber)

Geral

• Origem — a origem do documento que você deseja exibir. Os tipos de arquivos suportados são PDF documentos e imagens (JPEG, PNG, BMP, GIF e WEBP).
• Oculto — se verdadeiro, oculta o controle no tempo de execução.
• Desabilitado — se verdadeiro, desabilita o controle no tempo de execução.

Events

Não há eventos.

Estilo

• Alinhamento de controle — Por padrão, herda o alinhamento parent. É possível definir outro alinhamento que não o pai. Para voltar ao alinhamento padrão pai, desmarque as opções substituídas.
  Observação:

  O alinhamento depende do layout selecionado para o pai (Vertical vs. Horizontal).

• Borda — define a borda do controle. Espessura, cor e raio da borda podem ser configurados.
• Margem — a margem do controle. Por padrão, uma margem de 4px é definida. As propriedades Top/Bottom e Left/Right são combinadas. Essas propriedades podem ser desanexadas usando o botão Link no lado direito da seção Margem .
• Tamanho — a largura e a altura do controle. Por padrão, o tamanho é definido como auto, o que significa 320 x 410px. Para definir valores mínimos ou máximos, selecione o ícone de três pontos (*).

Propriedades VB

Propriedade do VB	Tipo de dados	Description
Source	IResource	O arquivo de origem exibido no momento.
Value	IResource	Valor anexado ou resultante do controle Visualizador de documentos .
Hidden	Booleano	Se verdadeiro, oculta o controle no tempo de execução.
Disabled	Booleano	Se verdadeiro, desabilita o controle no tempo de execução.