Nevron Vision for SharePoint Documentation
The Barcode Layout

Nevron Barcode for SharePoint supports multiple barcode areas and titles. In order to take full advantage of this feature you must understand how the barcode layout system works.

Panels and the Box Model

Nevron Barcode for SharePoint treats barcode areas and titles as panels. Panels use a box model, which is summarized by the following drawing: 

Each panel has margins and padding. The margins define a white space around each panel. The padding defines the space with which the panel content is padded (inflated). The margins and padding settings can be inherited from the barcode default margins and padding settings, if the respective Automatic property is set to true.

By default the Automatic property for the margins and padding of all panels is set to true and the actual margins and padding are obtained from the barcode control default margins and padding. You can modify the default margins and padding from the Barcode > Layout tab. The margins and padding of each panel are accessible from the Layout tab for that panel.

In general the layout algorithm described below uses a combination of docking and absolute positioning. When a panel is docked both it margins and padding are taken into account to display the content at its best size. When a panel is manually positioned the margins are ignored, since they are not needed (margins define a white space, which only automatic layouts should consider).

The Layout Algorithm

The following image illustrates the layout areas in the Nevron Barcode for SharePoint product: 

The layout algorithm performs the following steps:

  1. Layout the Outer Titles

    Outer titles are such titles for which the Position property is set to Dock To Barcode.

    The Dock Position property in this case determines the side at which the title must be docked in the outer titles area and the alignment of the title in this side area. For example:

    Dock Position = Top Center means dock the title to the top side and align it in the center.

    Dock Position = Right Top means dock the title to the right side and align it to the top.

  2. Position the Barcode Areas Host Panel

    The barcode areas host panel is an invisible panel, which fills the space which remains after step 1 has been performed.

  3. Layout the Barcode Area Host Panels

    The barcode areas host panels are invisible panels, which are created for each barcode area. These panels are split into two sets - the ones that use automatic positioning and the ones that use manual positioning.

    A barcode area uses automatic positioning, if its Automatic position property is set to true (go to Barcode Area - Layout tab and set to true the Automatic property in the Position group). Automatically positioned barcode areas are placed in the cells of an imaginary grid, the sizing of which is determined by the Barcode - LayoutBarcode Areas Layout property group.

    A barcode area uses manual positioning, if its Automatic position property is set to false. In this case you can choose from one of the following manual position options:

    Manual Position Mode Description
    Root Box In this mode the barcode position is determined in percentages of the Barcode Areas Host Panel.
    Parent Box In this mode the barcode position is determined in percentages of the Barcode Area specified by the Parent Area combo.
    Parent Radial In this mode the barcode center is determined in polar coordinates (Offset, Angle) from the Barcode Area specified by the Parent Area combo. The size of the barcode is specified by the Width and Height settings.

    The Z order of the barcode areas is always determined by the order in which they appear in the Barcode Areas Collection.

  4. Layout the Inner Titles (for each barcode area host panel)

    Inner titles are such titles for which the Position property is set to Dock To Barcode Area. You must pick a barcode area to which to dock from the Barcode Area property. The Dock Position property in this case determines the side at which the title must be docked in the inner titles area of the barcode area host panel and the alignment of the title in this side area.

  5. Position the barcode areas (for each barcode area host panel)/

    The barcode area fills the space, which remains after steps 3 and 4 have been performed.

  6. Layout the Plot Titles (for each barcode area)

    Plot titles are such titles for which the Position property is set to Dock To Barcode Plot Area. You must pick a barcode area to which to dock from the Barcode Area property. The Dock Position property in this case determines the side at which the title must be docked in the barcode plot area and the alignment of the title in this side area.

  7. Layout the Floating Titles

    Floating titles are such titles for which the Position property is set to Manual. A floating title is positioned relatively to a pin point. The pin point coordinates are specified in percents of the area, which remained after the control border was applied (by the Pin X Percent and Pin Y Percent properties). The title is aligned to the pin point via the Pin Alignment property. For example:

    Pin X Percent = 0, Pin Y Percent = 0, Pin Alignment = Bottom Right - means position the pin point at the 0, 0 percents and align the title so that it is located at the bottom right side of the pin point.

 

 

 


©2016. Nevron Software LLC.

Send Feedback