Pular para o conteúdo principal
Este objeto expõe métodos e Properties para trabalhar com o layout da imagem. O objeto Layout serve como raiz para os blocos. Seus atributos são width e height. Esses parâmetros são definidos com valores iguais aos parâmetros correspondentes da página em preto e branco da imagem para a qual o objeto Layout está definido. Isso é feito automaticamente quando o objeto Layout é analisado ou reconhecido. O objeto Layout é um objeto persistente. Isso significa que o estado atual do objeto pode ser gravado em armazenamento persistente. Mais tarde, o objeto pode ser recriado lendo o estado do objeto do armazenamento persistente. Os métodos a seguir fornecem persistência ao objeto:

​
Properties

,somente leitura

Retorna o objeto Engine.

,somente leitura

Fornece acesso à coleção de blocos de separador e de grupo de separadores do layout.

Esta propriedade faz referência a um objeto válido independentemente de haver ou não blocos de separador no Layout. Se não houver separadores no Layout, a propriedade BlackSeparators estará vazia.

,somente leitura

Fornece acesso à coleção de blocos do layout. Esta coleção não contém blocos de separador nem de grupo de separadores. Para acessar esses blocos, use a propriedade BlackSeparators.

Esta propriedade faz referência a um objeto válido independentemente de haver ou não blocos no Layout. Se não houver blocos no Layout, a propriedade Blocks estará vazia. Consulte tambémTrabalhando com propriedades de objeto somente leitura.

Esta coleção nunca contém blocos de autoanálise, pois esse tipo de bloco é usado apenas em Visual Components.

,somente leitura

Retorna a coleção de blocos do layout ordenada logicamente.

Esta coleção contém os mesmos blocos retornados pela propriedade Blocks. Eles são ordenados pela posição do canto superior esquerdo de cada bloco, primeiro da esquerda para a direita e depois de cima para baixo. Os blocos próximos entre si são considerados parte de um grupo lógico.

,somente leitura

Visual Components atualmente são suportados apenas no Windows.

Fornece acesso à coleção de blocos visíveis em Visual Components. Esta coleção pode conter blocos dos seguintes tipos: texto, tabela, imagem raster, código de barras, autoanálise. A ordem dos blocos nesta coleção é a mesma exibida em Visual Components.

, somente leitura

Retorna a altura do layout em pixels. É igual à altura deda.

Armazena o nome do layout.

, read-only

Grava o texto de todos os blocos de texto e de tabela em uma única linha. O objetodetermina a ordem em que o texto das células da tabela é gravado. Portanto, a ordem pode não coincidir com a ordem das células da tabela conforme aparecem na imagem. O texto de blocos de código de barras não é gravado.

,read-only

Armazena a região delimitadora dos blocos do layout. Se não houver blocos, esta propriedade retorna a região vazia.

Permite associar qualquer informação definida pelo usuário a um objeto do tipo Layout .

, read-only

Retorna a largura do layout em pixels. É igual à largura dedocorrespondente.

​
Métodos

NomeDescrição
CleanRemove todos os tipos de blocos e separadores do layout.
CopyFromInicializa as Properties do objeto atual com os valores de Properties correspondentes de outro objeto.
LoadFromFileRestaura o conteúdo do objeto de um arquivo no disco.
LoadFromMemory <Note> Somente para Windows. </Note>Restaura o conteúdo do objeto da memória global.
SaveToArraySalva o conteúdo do objeto como um array de bytes.
SaveToFileSalva o conteúdo do objeto em um arquivo no disco.
SaveToMemory <Note> Somente para Windows. </Note>Salva o conteúdo do objeto na memória global.
SaveToStreamSalva o conteúdo do objeto no stream.

​
Windows

Layout

​
Linux e macOS

LayoutLinuxMac Diagrama de objetos

​
Parâmetro de saída

Este objeto é o parâmetro de saída do método CreateLayoutFromStream do objeto Engine.

​
Exemplos

FREngine.IFRDocument frdoc;
// Iterates blocks of layout
for (int iPage = 0; iPage < frDoc.Pages.Count; iPage++)
{
 FREngine.IFRPage page = frDoc.Pages[iPage];
 FREngine.ILayout layout = page.Layout;
 int blocksCount = layout.Blocks.Count;
 for (int iBlock = 0; iBlock < blocksCount; iBlock++)
 {
  FREngine.IBlock block = layout.Blocks[iBlock];
  ...
 }
}
Este objeto é usado nos exemplos de código a seguir:

​
Veja também

Como trabalhar com Layout e Blocos LayoutBlocks Como trabalhar com Properties