LEADTOOLS WCF OCR (Leadtools.Services.Forms.DataContracts assembly) Send comments on this topic. | Back to Introduction - All Topics | Help Version 17.0.3.31
Zones Property
See Also 
Leadtools.Services.Forms.DataContracts Namespace > OcrPageZones Class : Zones Property



The Zones Property is available in LEADTOOLS Document and Medical Imaging toolkits.

A list of OcrZone objects that specifies the user defined zones for the page.

Syntax

Visual Basic (Declaration) 
<DataMemberAttribute(Name="Zones", IsRequired=True)>
Public Property Zones As OcrZones
Visual Basic (Usage)Copy Code
Dim instance As OcrPageZones
Dim value As OcrZones
 
instance.Zones = value
 
value = instance.Zones
C# 
[DataMemberAttribute(Name="Zones", IsRequired=true)]
public OcrZones Zones {get; set;}
C++/CLI 
[DataMemberAttribute(Name="Zones", IsRequired=true)]
public:
property OcrZones^ Zones {
   OcrZones^ get();
   void set (    OcrZones^ value);
}

Property Value

A list of OcrZone objects that specifies the user defined zones for the page.

Example

For an example, refer to DocumentConvertOptions.PagesZones

Remarks

The OcrPageZones contains a list of OcrZones and a page number to be used in the recognition process. To use your own zones in the recognition process, you must create an object of type OcrPagesZones and set it in the DocumentConvertOptions.PagesZones member. Then you must create an object of type OcrPageZones for each page in the document that requires special zone processing. Add the zones you have pre-calculated along with the corresponding page number to an OcrPageZones object and add it to the OcrPagesZones collection.

The Zones property contains a list of OcrZone objects, each zone defines a rectangular area on a page containing a feature of interest to the user.

The PageNumber is the 1-based page number in the source document (DocumentConvertOptions.Source) associated with the zones. This value is the 1-based page number regardless of the value of DocumentConvertOptions.FirstPageNumber, for example, you want the recognition to start at page 3 in the source document and you have zones for this page, you must set the OcrPageZones.PageNumber property to 3.

If the Zones collection does not contain any zones (is empty), then the service will perform auto-zoning on the page. This is the equivalant as passing null (Nothing in Visual Basic) to the DocumentConvertOptions.PagesZones property. Another way is to simply not add a OcrPageZones collection that contains the page number.

One feature to use with OcrPageZones is to stop the service from recognizing a certain page or pages in the document and either disregard them when creating the output document or add them as graphics pages if supported (for example, PDF). To achieve this, create an OcrPageZones object for the page, then add an OcrZone object with its OcrZone.ZoneType property set to OcrZoneType.Graphic and its OcrZone.Bounds set to the whole page size.

Requirements

Target Platforms: Microsoft .NET Framework 3.0, Windows 2000, Windows XP, Windows Server 2003 family, Windows Server 2008 family, Windows Vista, Windows 7

See Also

Applications developed with LEADTOOLS WCF components require runtime licenses. Server licensing is required for applications on a server. For more information, refer to: Imaging Pro/Document/Medical Features