Navigation:  Updates >

Update to Version 3

Print this Topic    Previous pageReturn to chapter overviewNext page

Important changes and extensions

Changed DLLs
All DLL file names were changed. The file names contain the new version number of bBrowser 3:

File Name (old)

File Name (new)

bBrw20.DLL

bBrowser.DLL

bBrw30.DLL

bServ20.DLL

bServer.DLL

bServ30.DLL

bSystem.DLL

bBrw30.DLL

bGUI.DLL

bBrw30.DLL

 

Strong typing removed
The strong typing was removed for the following methods, accesses and assigns:

bBrowser:RemoveColumnAll()

 

Methods and accesses no longer supported
The following methods and accesses are no longer supported and should not be used:

bGrid:Overlapped

See the topic for more information.

New classes

bBorderStyle

bBrowserColumn

bCodeblock

bDragDropClient

bDragDropManager

bFocusStyle

bGroupColumn

bRectangle

bSpinEdit

New methods

bArrayServer

GetLookupTable()

 

bBrowser

AdjustColumnBands()

AlphaBlendRatio

CalculateWidthOfColumnArea()

EnableDragSelection()

EnableThemePart()

FocusView

GetCaptionFrameFromPoint()

GetCaptionFromPoint()

GetCellFocusRect()

GetColumnAlphaBlendRatio()

GetColumnBandNo()

GetDefaultFont()

GetFooterFromPoint()

GetInfoAlphaBlendRatio()

GetTitleAlphaBlendRatio()

GetValueRect()

Handle()

IsDragSelectionEnabled()

IsThemePartEnabled()

PropertyExist()

SelectionRestore()

SelectionSave()

SelectorClick()

SelectorDoubleClick()

SelectorWidth

Wallpaper

WallpaperView

 

bDataColumn

PropertyExist()

 

bGrid

GetHeightOfStyle()

GetWidthOfStyle()

InnerSpace

OuterSpace

 

bItemList

GetPos()

 

bViewStyle

AlphaBlendRatio

Changes in methods and accesses

bBrowser

CurrentMode

New supported value:

#None




GetCaptionRect(),
GetColumnRect(),
GetFooterRect(),
IsColumnVisible(),
MoveColumn(),
ResizeColumn(),
ResizeColumnAuto()

New supported arguments:

<cColumn>

<symColumn>

<oColumn>




ProcessState

New supported constants:

BPS_INEDITSTART

BPS_INEDITCLOSE

BPS_INEDITCANCEL




PropertyPut(),
PropertyGet(),
PropertyDelete()

New supported properties:

#RMASelectionMode

#RTFInterfaceClass




RemoveColumnAll()

New supported argument:

<lDestroy>




bDataColumn

NameSym

Changed return value

 

PropertyPut(),
PropertyGet(),
PropertyDelete()

New supported properties:

#RTFInterfaceClass




bGrid

Init()

New supported arguments:

<oInnerSpace>

<oOuterSpace>

<oForeground>




Style

New supported constants:

BGRID_CONVEXSMOOTH

BGRID_AUTO

New funktions

bvsIsVisualStylesEnabled()

New and changed samples

bSample - bGroupColumn

bSample - Blinking

bSample - DragDrop

bSample - Wallpaper

Other changes and extensions

New base class for class bDataColumn
The class bDataColumn is now inherited from the new class bBrowserColumn. Many methods which were defined in the class bDataColumn have ben moved to the new bBrowserColumn class.

bBrowser and Visual Styles
The class bBrowser now supports Visual Styles (XP-Designs) in the areas below:

Title

Column Caption

Column Footer

Selector

Grid in Data Area

So that the areas are shown with the Visual styles, the grid style BGRID_AUTO must be defined in the grid of the appropriate area. This is now defined automatically when creating a bBrowser control.

If the operating system or the application does not support Visual Styles then the areas in which the grid style BGRID_AUTO is defined are represented with an alternative grid. The table below lists the alternative grid styles:

Area

Alternative Grid-Style

Title

BGRID_CONVEX

Column Caption

BGRID_CONVEX

Column Footer

BGRID_CONVEX

Selector

BGRID_CONVEX

Grid in Data Area

BGRID_OUTLINE

 

The support of Visual Styles can be enabled or disabled for an area with the method bBrowser:EnableThemePart(). When creating a bBrowser control, Visual Styles are enabled for all areas as long as the application and the operating system supports the Visual Styles. Otherwise, Visual Styles are disabled for all areas.

If the new representation of the bBrowser with full Visual Style support is not desired, then the old representation of the bBrowser 2 can be reconfigured with the following code fragment:

oBrowser:EnableThemePart(BVSTP_TITLE, FALSE)

oBrowser:EnableThemePart(BVSTP_INFO, FALSE)

oBrowser:EnableThemePart(BVSTP_SELECTOR, FALSE)

oBrowser:EnableThemePart(BVSTP_CAPTION, FALSE)

oBrowser:EnableThemePart(BVSTP_FOOTER, FALSE)

oBrowser:EnableThemePart(BVSTP_GRID, FALSE)

 

The code fragment must implemented after creating a bBrowser control. Further, the alpha blend ratio for colors must be adjusted. See the next paragraph for this.

bBrowser and color alpha blending (AlphaBlendRatio)
The bBrowser supports color alpha blending now. This means that one color overlaps another color. The overlapped color is seen through the other one. The top color is transparent. The higher the ratio of the overlapping, the lower is the transparency. The lower the ratio, the more it shows through the other. The alpha blend ratio can be defined with the new access bBrowser:AlphaBlendRatio. bBrowser supports color alpha blending for the following areas:

Title

Column Caption

Column Data

Column Footer

Selector

Info Value

In addition to the setting in bBrowser:AlphaBlendRatio a special alpha blend ratio can be defined for each of the areas above in its related bViewStyle object. For this the ratio must be defined with the access bViewStyle:AlphaBlendRatio. The following table lists the accesses for the bViewStyle objects of the areas:

Area

Access

Title

bBrowser:TitleView

Column Caption

bBrowser:CaptionView

Column Data

bBrowser:DataView

Column Footer

bBrowser:FooterView

Selector

bBrowser:SelectorView

Info Value

bBrowser:InfoView

 

To disable color alpha blending, the value BABR_NONE must be assigned to the access bBrowser:AlphaBlendRatio. As default the value BABR_NORMAL is defined. To disable the color alpha blending only in one of the different areas of the bBrowser, the value BABR_NONE must be assigned to the access bViewStyle:AlphaBlendRatio. For the different areas in the bBrowser the values below are defined as default:

Area

Access

Title

BABR_AUTO

Column Caption

BABR_AUTO

Column Data

BABR_AUTO

Column Footer

BABR_AUTO

Selector

BABR_AUTO

Info Value

BABR_AUTO

 

For the representation of color conditions the alpha blend ratio is used from the access bBrowser:DataView. To represent color conditions without alpha blending the value BABR_NONE must be assigned to the access.

Important note!
The alpha blend ratio is supported only for Windows 2000 and newer operating systems.

bBrowser and ToolTips
The behaviour of the access bBrowser:ToolTipMode  was changed for the mode #Cell. With this mode the column value is displayed now if the tooltip does not cover the complete cell.

bBrowser and selecting of cells and rows with the mouse
With the method bBrowser:EnableDragSelection() the block selection of cells and rows can be enabled or disabled. Block selection is enabled when creating a bBrowser control.

 


Page url: http://www.YOURSERVER.com/index.html?update_version_3.htm