Vai al contenuto principale
Questo oggetto espone metodi e proprietà per lavorare con il layout dell’immagine. L’oggetto Layout funge da oggetto radice per i Block. I suoi attributi sono la larghezza e l’altezza. Questi parametri vengono impostati automaticamente sugli stessi valori dei parametri corrispondenti della pagina in bianco e nero dell’immagine per cui è definito l’oggetto Layout. Questa operazione viene eseguita automaticamente quando l’oggetto Layout viene analizzato o riconosciuto. L’oggetto Layout è un oggetto persistente. Ciò significa che lo stato corrente dell’oggetto può essere scritto in una memoria persistente. In seguito, l’oggetto può essere ricreato leggendo il suo stato dalla memoria persistente. I seguenti metodi consentono di salvare e ripristinare l’oggetto:

​
Proprietà

,di sola lettura

Restituisce l’oggetto Engine.

,read-only

Fornisce accesso alla raccolta di blocchi separator e separator group del layout.

Questa proprietà fa riferimento a un oggetto valido indipendentemente dalla presenza di blocchi separator nel Layout. Se non sono presenti separator nel Layout, la proprietà BlackSeparators è vuota.

,read-only

Fornisce accesso alla raccolta di blocchi del layout. Questa raccolta non contiene i blocchi separator e separator group. Per accedere a questi blocchi, utilizzare la proprietà BlackSeparators.

Questa proprietà fa riferimento a un oggetto valido indipendentemente dalla presenza di blocchi nel Layout. Se non sono presenti blocchi nel Layout, la proprietà Blocks è vuota. Vedere ancheUtilizzo delle proprietà degli oggetti di sola lettura.

Questa raccolta non contiene mai blocchi di autoanalisi, poiché questo tipo di blocchi viene utilizzato esclusivamente nei Visual Components.

,read-only

Restituisce la raccolta dei blocchi del layout ordinata logicamente.

Questa raccolta contiene gli stessi blocchi restituiti dalla proprietà Blocks, ordinati in base alla posizione dell’angolo superiore sinistro di ciascun blocco: prima da sinistra a destra, poi dall’alto verso il basso. I blocchi ravvicinati vengono considerati parte di un unico gruppo logico.

,read-only

I Visual Components sono attualmente supportati solo su Windows.

Fornisce accesso alla raccolta di blocchi visibili nei Visual Components. Questa raccolta può contenere blocchi dei seguenti tipi: testo, tabella, immagine raster, barcode, autoanalisi. L’ordine dei blocchi in questa raccolta corrisponde a quello visualizzato nei Visual Components.

, read-only

Restituisce l’altezza del layout in pixel. È uguale all’altezza didel corrispondente.

Memorizza il nome del layout.

, read-only

Scrive il testo di tutti i blocchi di testo e di tabella su una sola riga. L’oggettodetermina l’ordine in cui viene scritto il testo delle celle di tabella. L’ordine potrebbe quindi non coincidere con quello delle celle di tabella nell’immagine. Il testo dei blocchi barcode non viene scritto.

,read-only

Memorizza la regione di delimitazione dei blocchi del layout. Se non sono presenti blocchi, questa proprietà restituisce la regione vuota.

Consente di associare qualsiasi informazione definita dall’utente a un oggetto di tipo Layout .

, read-only

Restituisce la larghezza del layout in pixel. Corrisponde alla larghezza didellacorrispondente.

​
Metodi

NomeDescrizione
CleanRimuove tutti i tipi di blocchi e Separator dal layout.
CopyFromInizializza le proprietà dell’oggetto corrente con i valori delle proprietà corrispondenti di un altro oggetto.
LoadFromFileRipristina il contenuto dell’oggetto da un file su disco.
LoadFromMemory <Note> Solo Windows. </Note>Ripristina il contenuto dell’oggetto dalla memoria globale.
SaveToArraySalva il contenuto dell’oggetto come array di byte.
SaveToFileSalva il contenuto dell’oggetto in un file su disco.
SaveToMemory <Note> Solo Windows. </Note>Salva il contenuto dell’oggetto nella memoria globale.
SaveToStreamSalva il contenuto dell’oggetto nello stream.

​
Windows

Layout

​
Linux e macOS

LayoutLinuxMac Diagramma degli oggetti

​
Parametro di output

Questo oggetto è il parametro di output del metodo CreateLayoutFromStream dell’oggetto Engine.

​
Esempi

FREngine.IFRDocument frdoc;
// Scorre i Block del 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];
  ...
 }
}
L’oggetto viene usato nei seguenti esempi di codice:

​
Vedi anche

Utilizzo di Layout e Block LayoutBlocks Utilizzo delle proprietà