Prev |  | Next

## 3.32. Text - in Page Regions

### Overview

You might find that a certain text exists more than once on a page, but only one of the occurrences has to be tested. This requires you to narrow the search to a section of a page. The syntax is simple:

    // Reducing the validation to a page region:
    .restrictedTo(PageRegion)
    // The following validations are limited to the regions.

### Example

The following example shows the definition and the usage of a page region:

    @Test
    public void hasTextOnFirstPageInPageRegion() throws Exception {
      String filename = "documentUnderTest.pdf";

      int leftX  =  17;  // in millimeter
      int upperY =  45;
      int width  =  60;
      int height =   9;
      PageRegion pageRegion = new PageRegion(leftX, upperY, width, height);

      AssertThat.document(filename)
                .restrictedTo(FIRST_PAGE)
                .restrictedTo(pageRegion)
                .hasText()
                .startingWith("Content")
                .containing("on first")
                .endingWith("page.")
      ;
    }

When comparing text in page areas, all the test methods are available which are available when comparing text on entire pages. These methods are described in section 13.4: “Comparing Text”.

A page region can also be used when testing images.

Prev | Up | Next
3.31. Text - in Images (OCR) | Home | 3.33. Text - Ordered Text