Zones Property

[DataMemberAttribute(Name="Zones", IsRequired=true)]
public OcrZones Zones {get; set;}

'Declaration
 
<DataMemberAttribute(Name="Zones", IsRequired=True)>
Public Property Zones As OcrZones

'Usage
 
Dim instance As OcrPageZones
Dim value As OcrZones
 
instance.Zones = value
 
value = instance.Zones

[DataMemberAttribute(Name="Zones", IsRequired=true)]
public:
property OcrZones^ Zones {
   OcrZones^ get();
   void set (    OcrZones^ value);
}

Property Value

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 equivalent 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.

Target Platforms

Reference

OcrPageZones Class
OcrPageZones Members