Methods > Operations > GetRectangle method

Remarks

Obtains the rectangle where a specific graphic element is positioned inside the Waveform Analyzer.

Syntax

[Visual Basic]

control.GetRectangle (

nIdRectangle as enumWaveAnalyzerRectangles,

nIdSecondary as Integer,

nLeft as Long,

nTop as Long,

nWidth as Long,

nHeight as Long

) as enumWanErrorCodes

[C++]

short control.GetRectangle (

short nIdRectangle,

short nIdSecondary,

long *nLeft,

long *nTop,

long *nWidth,

long *nHeight

);

Parameter

Description

nIdRectangle

Mnemonic Identifier of the graphic element

Supported values are the following:

Mnemonic value	Value	Meaning
WAVEANALYZER_RECT_TOTAL	0	Total rectangle
WAVEANALYZER_RECT_WAVEFORM	1	Waveform rectangle
WAVEANALYZER_RECT_WAVEFORM_LEFT_CH	2	Waveform rectangle for left channel
WAVEANALYZER_RECT_WAVEFORM_RIGHT_CH	3	Waveform rectangle for right channel
WAVEANALYZER_RECT_SB_TOP	4	Top scrollbar rectangle
WAVEANALYZER_RECT_SB_BOTTOM	5	Bottom scrollbar rectangle
WAVEANALYZER_RECT_RULER_LEFT	6	Left ruler rectangle
WAVEANALYZER_RECT_RULER_RIGHT	7	Right ruler rectangle
WAVEANALYZER_RECT_RULER_TOP	8	Top ruler rectangle
WAVEANALYZER_RECT_RULER_BOTTOM	9	Bottom ruler rectangle
WAVEANALYZER_RECT_SELECTION	10	Selected rectangle
WAVEANALYZER_RECT_PLAYBACK_LINE	11	Playback line rectangle
WAVEANALYZER_RECT_CUSTOM_LINE	12	Custom vertical line rectangle. If nWidth and nHeight dimensions of the rectangle are both set to 0, this means that the line is not on the visible area of the waveform
WAVEANALYZER_RECT_HORZ_LINE_LEFT	13	Horizontal line on left channel rectangle. If nWidth and nHeight dimensions of the rectangle are both set to 0, this means that the line is not on the visible area of the waveform
WAVEANALYZER_RECT_HORZ_LINE_RIGHT	14	Horizontal line on right channel rectangle. If nWidth and nHeight dimensions of the rectangle are both set to 0, this means that the line is not on the visible area of the waveform
WAVEANALYZER_RECT_WAVE_RANGE	15	Wave range rectangle. If nWidth and nHeight dimensions of the rectangle are both set to 0, this means that the wave range is not on the visible area of the waveform

nIdSecondary

Unique identifier of a specific graphic item added to the analyzer through a call to one of the following methods:

•	GraphicItemHorizontalLineAdd for horizontal lines

•	GraphicItemVerticalLineAdd for vertical lines

•	GraphicItemWaveRangeAdd for wave ranges

Leave this parameter to 0 if the value of the nIdRectangle parameter is different from WAVEANALYZER_RECT_CUSTOM_LINE, WAVEANALYZER_RECT_HORZ_LINE_LEFT, WAVEANALYZER_RECT_HORZ_LINE_RIGHT or WAVEANALYZER_RECT_WAVE_RANGE.

nLeft

Reference that, after returning from the method call, will contain the left coordinate, expressed in pixels, of the requested rectangle respect to the client area of the Waveform Analyzer.

nTop

Reference that, after returning from the method call, will contain the top coordinate, expressed in pixels, of the requested rectangle respect to the client area of the Waveform Analyzer.

nWidth

Reference that, after returning from the method call, will contain the width, expressed in pixels, of the requested rectangle.

nHeight

Reference that, after returning from the method call, will contain the height, expressed in pixels, of the requested rectangle

Return value

Value	Meaning

Negative value	An error occurred (see the LastError property for further error details)
enumWanErrorCodes.ERR_WAN_NOERROR (0)	The method call was successful