Copyright © 2013-2014 MultiMedia Soft

WANALYZER_SCROLLBARS_SETTINGS structure

Previous pageReturn to chapter overviewNext page

The WANALYZER_SCROLLBARS_SETTINGS structure describes settings applied while rendering the scrollbars on the Waveform Analyzer. The current settings can be retrieved through the SettingsScrollbarsGet method and modified through the SettingsScrollbarsSet method.

 

 

Visual C++ definition

 

typedef struct

{

     short nHeightInPixels;

     long nType;

     long nGraphicItemsMask;

     short bVisibleTop;

     short bVisibleBottom;

     OLE_COLOR colorBackground;

     OLE_COLOR colorThumb;

     OLE_COLOR colorVisibleRange;

     long nVisibleRangeType;

     short nVisibleRangeTranspGlassFactor;

     short nVisibleRangeLinesWidth;

     short bReserved;

     long nTransparentGlassType;

     short nTransparentGlassPos3D;

     short bTransparentGlassInvert3D;

} WANALYZER_SCROLLBARS_SETTINGS;

 

This data structure is defined inside the WavMmsEngDef.h header file which can be found inside the product's Include directory (default C:\Program Files\Active Waveform Analyzer\include).

 

Visual Basic definition

 

Public Type WANALYZER_SCROLLBARS_SETTINGS

    nHeightInPixels as Integer

    nType as enumWaveScrollbarType

    nGraphicItemsMask as enumGraphicItemMaskValues

    bVisibleTop as Boolean

    bVisibleBottom as Boolean

    colorBackground as OLE_COLOR

    colorThumb as OLE_COLOR

    colorVisibleRange as OLE_COLOR

    nVisibleRangeType as enumScrollbarWaveVisibleRangeType

    nVisibleRangeTranspGlassFactor as Integer

    nVisibleRangeLinesWidth as Integer

    bReserved as Boolean

    nTransparentGlassType as enumTranspGlassType

    nTransparentGlassPos3D as Integer

    bTransparentGlassInvert3D as Boolean

End Type

 

This data structure is defined inside the AsoedDef.bas module file which can be found inside the product's Include directory (default C:\Program Files\Active Sound Recorder\include).

 

 

Member

Description

 

 

nHeightInPixels

Height of the scrollbars in pixels.

By default this value is set to 12.

If the nType field below is set to WSCROLLBAR_TYPE_RECT, this field cannot be set to a value smaller than 6.

If the nType field below is set to WSCROLLBAR_TYPE_WAVEFORM, this field cannot be set to a value smaller than 12.

Eventual smaller values will be automatically capped to the nearest valid value.

nType

Determines how the scrollbar is visualized.

Supported values are the following:

Mnemonic constant

Value

Meaning

WSCROLLBAR_TYPE_RECT (default)

0

Scrollbars are rendered as a 3D rectangle

WSCROLLBAR_TYPE_WAVEFORM

1

Scrollbars display a small sized representation of the full waveform

 

On the screenshots below you can see that two different types of scrollbar; in both cases you can resize the visible range by dragging the provided handles with the left mouse button:

 

nGraphicItemsMask

Combination of values determining the mask of graphic items that must be drawn on the waveform scrollbar.

By default this

Supported values are the following:

Mnemonic constant

Value

Meaning

MASK_GRAPHIC_ITEM_NONE (default)

0

No graphic item is drawn

MASK_GRAPHIC_ITEM_VERTICAL_LINE

1

Draws vertical lines

MASK_GRAPHIC_ITEM_HORIZONTAL_LINE

2

Draws horizontal lines

MASK_GRAPHIC_ITEM_WAVE_RANGE

4

Draw wave ranges

bVisibleTop

Boolean value that specifies if the top scrollbar is visible.

Supported values are the following:

Mnemonic constant

Meaning

BOOL_FALSE

Doesn't display top scrollbar

BOOL_TRUE (default)

Displays top scrollbar

bVisibleBottom

Boolean value that specifies if the bottom scrollbar is visible.Supported values are the following:

Mnemonic constant

Meaning

BOOL_FALSE

Doesn't display bottom scrollbar

BOOL_TRUE (default)

Displays bottom scrollbar

colorBackground

Color used for rendering the scrollbars background.

colorThumb

Color used for rendering the scrollbars thumb.

colorVisibleRange

Color used for rendering inside the scrollbars the waveform background for visible range.

This setting is ignored when the nType field above is set to a value different from WSCROLLBAR_TYPE_WAVEFORM.

nVisibleRangeType

Determines how the visible range of the waveform is displayed.

This setting is ignored when the nType field above is set to a value different from WSCROLLBAR_TYPE_WAVEFORM

Supported values are the following:

Mnemonic constant

Value

Meaning

SCROLL_WAVE_VISIBLE_LINES (default)

0

Displays two lines on top and bottom

SCROLL_WAVE_VISIBLE_LINE_TOP

1

Displays one line on top

SCROLL_WAVE_VISIBLE_LINE_BOTTOM

2

Displays one line on bottom

SCROLL_WAVE_VISIBLE_TRANSP_GLASS_INNER

3

Displays a transparent glass over the portion of waveform representing the visible range

SCROLL_WAVE_VISIBLE_TRANSP_GLASS_OUTER

4

Displays a transparent glass over portions of waveform representing ranges of the waveform outside of the visible area.

nVisibleRangeTranspGlassFactor

Transparent factor applied to the transparent glass.

This value can range from 0 (total opacity) to 255 (total transparency)  with a default value of 128. Values outside of this range will be automatically capped to the nearest valid value.

This setting is ignored when the nType field above is set to a value different from WSCROLLBAR_TYPE_WAVEFORM.

This setting is ignored when the nVisibleRangeType field above is set to a value different from SCROLL_WAVE_VISIBLE_TRANSP_GLASS_INNER or SCROLL_WAVE_VISIBLE_TRANSP_GLASS_OUTER.

nVisibleRangeLinesWidth

Width of lines in pixels.

Cannot assume values smaller than 1. The default value is 2.

This setting is ignored when the nType field above is set to a value different from WSCROLLBAR_TYPE_WAVEFORM.

This setting is ignored when the nVisibleRangeType field above is set to SCROLL_WAVE_VISIBLE_TRANSP_GLASS_INNER or SCROLL_WAVE_VISIBLE_TRANSP_GLASS_OUTER.

bReserved

Reserved for future uses.

nTransparentGlassType

Type of transparent glass.

Supported values are the following:

Mnemonic constant

Value

Meaning

TRANSP_GLASS_TYPE_FLAT

0

Flat glass.

TRANSP_GLASS_TYPE_3D_VERT (default)

1

3D vertical glass.

TRANSP_GLASS_TYPE_3D_HORZ

2

3D horizontal glass.

This setting is ignored when the nType field above is set to a value different from WSCROLLBAR_TYPE_WAVEFORM.

This setting is ignored when the nVisibleRangeType field above is set to a value different from SCROLL_WAVE_VISIBLE_TRANSP_GLASS_INNER or SCROLL_WAVE_VISIBLE_TRANSP_GLASS_OUTER.

nTransparentGlassPos3D

Position of the 3D effect for the transparent glass.

This value can range from 0 to 100 with a default value of 50. Values outside of this range will be automatically capped to the nearest valid value.

This setting is ignored when the nType field above is set to a value different from WSCROLLBAR_TYPE_WAVEFORM.

This setting is ignored when the nVisibleRangeType field above is set to a value different from SCROLL_WAVE_VISIBLE_TRANSP_GLASS_INNER or SCROLL_WAVE_VISIBLE_TRANSP_GLASS_OUTER.

nTransparentGlassInvert3D

Boolean value that specifies if the transparency of the 3D effect is inverted.

Supported values are the following:

Mnemonic constant

Meaning

BOOL_FALSE (default)

Doesn't invert 3D effect

BOOL_TRUE

Inverts 3D effect

This setting is ignored when the nType field above is set to a value different from WSCROLLBAR_TYPE_WAVEFORM.

This setting is ignored when the nVisibleRangeType field above is set to a value different from SCROLL_WAVE_VISIBLE_TRANSP_GLASS_INNER or SCROLL_WAVE_VISIBLE_TRANSP_GLASS_OUTER.