PageContainer


A PageContainer control is an onscreen element that provides a way to implement linear navigation between pages of content, such as in a document, book, notepad, or calendar. Pages fluidly scroll from one to the next or turn like pages in a physical book.

PageContainer

Best practices

When a PageContaineris used, pages flow sequentially and there’s no way to jump between nonadjacent pages. If people may need to access pages out of sequence in your app, implement a custom control that provides this functionality.

How to use

  1. Drop a PageContainer control from the object panel to a Window
  2. Use the PageContainer Inspector to customize its Navigation style properties like DataSet, Style and its Page Curl properties like Style

PageContainer inspector The inspector where the PageContainer class can be configured.

Example

  1. Drop a PageContainer control from the object panel to a Window
  2. Create a DataSet of pictures by dropping images in the Project -> Assets folder
  3. Set the PageContainer DataSet property to Asset; now you can test the pages transition by tapping Play
  4. Drop an ImageView and a Label onto the PageContainer -> CustomView1. The ending hierarchy should look like
- Navigation1
 - Window1
  - PageContainer1
   - CustomView1
    - ImageView1
    - Label1
  1. Select CustomView1 and tap the Custom Properties button on the Inspector topbar.
  2. Right click and select New Property
  3. Add a property named "Image" and bind it to ImageView1.image
  4. Add a property named "Label" and bind it to Label1.text

PageContainer binding

  1. Open the PageContainer inspector and select Cell Properties
  2. Assign to Label the value Name
  3. Assign to Image the value Image
  4. Tap Play to see how the PageContainer content is now rendered with the Assets image and name
  5. Swipe to scroll

Most important properties

Several aspects can be configured in the PageContainer class but the most important are:

  • DataSet: To set the content source for the PageContainer
  • Style: PageCurl for turning pages like a book, PageScroll to fluidly scroll from one to the next page

References

PageContainer class reference contains a complete list of properties and methods that can be used to customize a PageContainer object.