This documentation is for the old version. Go to the latest Upload Suite docs

Additional Pane Item Controls

One of the most attractive view modes is the thumbnail view mode, as it displays small thumbnails of original images and is more obvious to the user. In this mode, the displayed thumbnails may have additional controls, both interactive and non-interactive.

To non-interactive controls belongs only the quality meter. Using all other controls the user can perform some actions. All these additional controls are described below.

Checkbox

Checkbox
Fig. 1. Checkbox

This control appears only in the two-pane layout mode and does not require any extra set-up, as it appears automatically. Using checkboxes the user can select files for upload.

If the AllowMultipleSelection property is set to false, radiobuttons will be displayed instead of checkboxes.

Large Preview Control

Large preview magnifier
Fig. 2. Large preview magnifier

This control appears both on the folder pane and the upload pane, hence, it supports all three layout modes. The control appears in a form of a magnifier when the user hovers the mouse pointer over some thumbnail in the pane. By clicking this magnifier the user opens a separate window where a larger preview of the selected image is displayed.

To add this control to the pane items, set the AllowLargePreview to true. The following additional properties will help you to customize this control:

Rotation Controls

Rotation arrows
Fig. 3. Rotation arrows

These controls appear both on the folder pane and the upload pane, hence, they support all three layout modes. These controls appear as a pair of arrows when the user hovers the mouse pointer over some thumbnail in the pane. By clicking one of arrows the user rotates the thumbnail by 90 degrees clockwise or counterclockwise.

To add these controls to the pane items, set the AllowRotate to true. The following additional properties will help you to customize this control:

There are two more properties that influence the behavior of these controls:

Removal Control

Removal cross
Fig. 4. Removal cross

This control appears only on the upload pane, hence, it supports the one-pane and three-pane layout modes. The control appears in a form of a cross when the user hovers the mouse pointer over some thumbnail in the pane. By clicking this cross the user removes the selected image from the upload list.

To add this control to the pane items, set the EnableRemoveIcon to true. The following additional properties will help you to customize this control:

There is one more property that influences the behavior of these controls: AllowMultipleRemove. It specifies if several thumbnails can be removed at once.

Quality Meter

Quality Meter
Fig. 5. Quality Meter

As it was mentioned above, this control is non-interactive, that is it only displays some information. It appears both on the folder pane and the upload pane, hence, it supports all three layout modes. It appears as a colored strip divided in sections, where each section corresponds to some predefined format.

To add this control to the pane items, set the QualityMeterFormats property to a list of formats. The strip will show up automatically. There are also a bunch of additional properties that allow appearance customizing of this control. They are:

See Also

Reference

Manual