Zone Editor

Edits properties of type Rectangle or Logical Rectangle, providing a visual and data-driven interface for zone configuration.

Remarks

The Zone Editor control enables users to define and edit rectangular zones on document images or within data properties. Zones are commonly used for specifying regions of interest for extraction, classification, or validation in Grooper workflows. The editor supports both direct property editing in the Property Grid and interactive zone selection by dragging rectangles on a document image.

UI Components

• Zone Properties Grid:
  • Displays all editable properties of the zone, such as coordinates, dimensions, and logical attributes.
  • Supports inline editing, validation, and contextual help.
  • Properties are grouped by category for clarity.
• Test Source:
  • Allows users to select or preview a test batch or document source for validating zone configuration.
  • Useful for verifying zone placement and behavior against real document samples.
• Document Viewer:
  • Renders the currently-selected document page, overlaying the zone as an annotation.
  • Supports interactive zone selection: drag a new rectangle or adjust the handles of the existing zone.
  • Provides zoom, pan, and fit-to-window options for detailed inspection.
  • May include context menu commands for image review, such as display format changes, rotation, and reset.

Interactive Features

• Zone Configuration:
  • Edit zone properties directly in the grid for precise control.
  • Use the selection tool in the viewer to drag and resize the zone visually.
  • Real-time feedback updates both the grid and the viewer as changes are made.
• Keyboard Navigation:
  • Tab: Move between input fields and controls.
  • Enter: Commit changes or activate selected controls.
  • Arrow Keys: Adjust zone position or size (if supported).
• Mouse Operations:
  • Drag to create or resize the zone.
  • Click handles to adjust dimensions.
  • Right-click for context menu commands (if available).

Usage Guidance

Use the Zone Editor to define regions of interest for extraction, validation, or classification. Configure zone properties in the grid for precise values, or use the viewer for intuitive, visual placement. Test zone configuration against sample documents to ensure accuracy and effectiveness.

• For extraction scenarios, set zones to target specific fields or regions.
• For validation, use zones to restrict processing to defined areas.
• Use the viewer to visually confirm zone placement and adjust as needed.

Accessibility

• Fully navigable by keyboard and mouse.
• Screen reader support for property grid, viewer, and controls.
• Visual cues for selection, focus, and zone overlays.

Example

┌───────────── Zone Editor ─────────────┐
│ Zone Property Grid                    │
│   - X: 100                            │
│   - Y: 200                            │
│   - Width: 300                        │
│   - Height: 150                       │
│ Test Source                           │
│ ┌───────────── Page Image ─────────┐  │
│ │     [Zone Overlay: Rectangle]    │  │
│ └──────────────────────────────────┘  │
└───────────────────────────────────────┘

Child Controls

Name	Type		Summary
Zone Properties	Property Grid	►	Displays the properties of the zone and allows editing. The Zone Properties grid presents all editable attributes of the zone, including coordinates, dimensions, and logical settings. It supports inline editing, validation, and contextual help, enabling precise configuration of the zone. Usage Edit zone properties directly in the grid. Review validation feedback and contextual help for each property. Use category grouping for clarity and organization. Accessibility Fully navigable by keyboard and mouse. Screen reader support for property names, values, and help content.
Test Source	Test Source	►	Provides a test batch or document source for validating zone configuration. The Test Source control allows users to select or preview a test batch or document source for validating zone placement and behavior. Usage Select a test batch or document to preview zone configuration. Use the test source to validate zone accuracy and effectiveness. Integrate with the document viewer for real-time feedback. Accessibility Fully navigable by keyboard and mouse. Screen reader support for selection controls and feedback.
Viewer	Document Viewer	►	Displays the currently-selected document, with the zone overlaid as an annotation. The Viewer control renders the document page, overlaying the zone as a rectangle annotation. Users can drag a new rectangle or adjust the handles of the existing zone for visual configuration. Usage Use the selection tool to drag and resize the zone. Preview zone placement and adjust as needed. Access context menu commands for image review (if available). Accessibility Fully navigable by keyboard and mouse. Screen reader support for page content and overlays.