COM Objects > WaveformAnalyzer object > Methods > WaveformAnalyzer.GetRectangle method

Remarks

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

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.

Syntax

[Visual Basic]

control.WaveformAnalyzer.GetRectangle (

nIdRectangle as enumWaveAnalyzerRectangles,

nIdSecondary as Integer,

nLeft as Long,

nTop as Long,

nWidth as Long,

nHeight as Long

) as enumErrorCodes

[C++]

short control.WaveformAnalyzer.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
WAVEANALYZER_RECT_WAVEFORM_CH_0	16	Waveform rectangle for channel 0
WAVEANALYZER_RECT_WAVEFORM_CH_1	17	Waveform rectangle for channel 1. If nWidth and nHeight dimensions of the rectangle are both set to 0, this means that the requested channel is not available.
WAVEANALYZER_RECT_WAVEFORM_CH_2	18	Waveform rectangle for channel 2. If nWidth and nHeight dimensions of the rectangle are both set to 0, this means that the requested channel is not available.
WAVEANALYZER_RECT_WAVEFORM_CH_3	19	Waveform rectangle for channel 3. If nWidth and nHeight dimensions of the rectangle are both set to 0, this means that the requested channel is not available.
WAVEANALYZER_RECT_WAVEFORM_CH_4	20	Waveform rectangle for channel 4. If nWidth and nHeight dimensions of the rectangle are both set to 0, this means that the requested channel is not available.
WAVEANALYZER_RECT_WAVEFORM_CH_5	21	Waveform rectangle for channel 5. If nWidth and nHeight dimensions of the rectangle are both set to 0, this means that the requested channel is not available.
WAVEANALYZER_RECT_WAVEFORM_CH_6	22	Waveform rectangle for channel 6. If nWidth and nHeight dimensions of the rectangle are both set to 0, this means that the requested channel is not available.
WAVEANALYZER_RECT_WAVEFORM_CH_7	23	Waveform rectangle for channel 7. If nWidth and nHeight dimensions of the rectangle are both set to 0, this means that the requested channel is not available.

nIdSecondary

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

•	WaveformAnalyzer.GraphicItemHorizontalLineAdd for horizontal lines

•	WaveformAnalyzer.GraphicItemVerticalLineAdd for vertical lines

•	WaveformAnalyzer.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)
enumErrorCodes.ERR_NOERROR (0)	The method call was successful