About Layout pane property effects on zoom behavior

Layout pane properties specified during design time determine some aspects of zoom behavior during runtime.

• The values assigned to the Display Mode property determine the placement of the graphic within a pane when a graphic is zoomed larger than the dimensions of a pane and whether a graphic retains its original aspect ratio.

  Important: The zoom percent range varies based on the value assigned to the Display Mode property. When Display Mode is set to Maintain Size, the zoom percent range is from 10 percent to 5000 percent. When Display Mode is set to Maintain Aspect or Stretch, the zoom percent range is from 100 percent to 5000 percent.

• The values assigned to the Content Alignment property determines the placement of graphic within a pane when zoomed larger than a pane in at least one dimension.

• Panning and zooming should be enabled for a pane and show the pan and zoom control icons during runtime.

  

  The following table lists important pane properties that will affect programmatic zoom control of graphics.

  Pane Property	Description
  Display Mode	Assigned value determines how a graphic is resized to fit the current pane size. For more detail about the different Display Mode values, see Set pane properties: display mode. Maintain Aspect is the default value to retain the aspect ratio of the graphic when it is zoomed larger or smaller. A graphic's left and right boundaries will align with the pane or its top and bottom boundaries will align with the pane. A graphic is truncated in any dimension that is larger than the pane's width or height. Maintain Size places a graphic within the pane based on the assigned Alignment and Padding property values when the content is smaller than the pane. When the size of a graphic exceeds the pane's boundary, the graphic retains its aspect ratio and is centered in the graphic and truncated in any dimension beyond the pane boundary. Stretch resizes the graphic regardless of its aspect ratio to completely fit within the dimensions of the pane.
  Content Alignment	Assigned value determines the alignment of the graphic within a pane area. For more information about the different Content Alignment values, see Set pane properties: display mode. Center is the default to place the center of the graphic at the center of the pane area.
  Interaction Mode	Assigned values determines whether the user can can pan or zoom the pane area. Pan and Zoom is the default to enable panning and zooming in a pane during runtime.
  Show Zoom Control	Assigned value determines if the pan and zoom controls are shown in a pane during runtime. The recommended value is to show both controls during runtime.