COM Objects > WaveformAnalyzer object > Data structures > WANALYZER_SCROLLBARS

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

For details about the use of the Waveform Analyzer refer to the How to use the Waveform Analyzer section.

For further details about methods of the Waveform Analyzer refer to the WaveformAnalyzer object section.

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 bEnabledDuringPlayback;

long nTransparentGlassType;

short nTransparentGlassPos3D;

short bTransparentGlassInvert3D;

} WANALYZER_SCROLLBARS_SETTINGS;

This data structure is defined inside the AdjMmsEngDef.h header file which can be found inside the product's Include directory (default \Program files\MultiMedia Soft\Active Sound Recorder\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

bEnabledDuringPlayback as Boolean

nTransparentGlassType as enumTranspGlassType

nTransparentGlassPos3D as Integer

bTransparentGlassInvert3D as Boolean

End Type

This data structure is defined inside the AdjMmsEngDef.bas module file which can be found inside the product's Include directory (default \Program files\MultiMedia Soft\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
WSCROLLBAR_TYPE_WAVEFORM_ABS	2	Scrollbars display a small sized representation of the full waveform with absolute values.

On the screenshots below you can see that two different types of scrollbar; in all 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.

bEnabledDuringPlayback

Boolean value that specifies if scrollbars are enabled during playback.

Supported values are the following:

Mnemonic constant	Meaning
BOOL_FALSE (default)	Scrollbars are disabled during playback
BOOL_TRUE	Scrollbars are enabled during playback

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.