COM Objects > TracksBoard object > Methods > TracksBoard.RectangleGet method

Remarks

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

For details about the use of the TracksBoard refer to the How to use the TracksBoard to visually compose songs tutorial.

For further details about methods of the TracksBoard refer to the TracksBoard object section.

Syntax

[Visual Basic]

control.TracksBoard.RectangleGet (

nIdRectangle as enumTracksBoardRectangles,

nIdFirst as Long,

nIdSecond as Long,

ByRef nLeft as Long,

ByRef nTop as Long,

ByRef nWidth as Long,

ByRef nHeight as Long

) as enumErrorCodes

[C++]

short control.TracksBoard.RectangleGet (

short nIdRectangle,

long nIdFirst,

long nIdSecond,

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

TRACKSBOARD_RECT_TOTAL

Total rectangle of the TracksBoard's window

TRACKSBOARD_RECT_ALL_TRACKS

Rectangle containing all of the tracks

TRACKSBOARD_RECT_SINGLE_TRACK

Rectangle of a single track; use the nIdFirst parameter to define the zero-based index of the track of interest

TRACKSBOARD_RECT_SB_TOP

Top horizontal scrollbar rectangle

TRACKSBOARD_RECT_SB_BOTTOM

Bottom horizontal scrollbar rectangle

TRACKSBOARD_RECT_SB_RIGHT

Right vertical scrollbar rectangle

TRACKSBOARD_RECT_RULER_LEFT

Left ruler rectangle

TRACKSBOARD_RECT_RULER_RIGHT

Right ruler rectangle

TRACKSBOARD_RECT_RULER_TOP

Top ruler rectangle

TRACKSBOARD_RECT_RULER_BOTTOM

Bottom ruler rectangle

TRACKSBOARD_RECT_SELECTION

Selected rectangle

TRACKSBOARD_RECT_PLAYBACK_LINE

Play head line rectangle

TRACKSBOARD_RECT_SINGLE_ITEM

Single item rectangle; use the nIdFirst parameter to define the unique identification number of the item of interest.

The unique identification number is assigned to the sound item after being generated by one of the following methods:

•	TracksBoard.ItemSoundFileAdd and TracksBoard.ItemSoundFileRawAdd for sound files

•	TracksBoard.ItemSpeechFromStringAdd and TracksBoard.ItemSpeechFromFileAdd for text to speech items

•	TracksBoard.ItemClone when an existing item has been cloned

TRACKSBOARD_RECT_SINGLE_VOLUME_POINT

Single volume point rectangle: use the nIdFirst parameter to define the unique identification number of the item of interest and the the nIdSecond parameter to define the zero-based index of the volume point of interest.

The unique identification number is assigned to the sound item after being generated by one of the following methods:

•	TracksBoard.ItemSoundFileAdd and TracksBoard.ItemSoundFileRawAdd for sound files

•	TracksBoard.ItemSpeechFromStringAdd and TracksBoard.ItemSpeechFromFileAdd for text to speech items

•	TracksBoard.ItemClone when an existing item has been cloned

The total number of volume points available for the given item can be obtained through the TracksBoard.ItemVolumePointCountGet method

nIdFirst

In case the nIdRectangle parameter should be set to TRACKSBOARD_RECT_SINGLE_TRACK this parameter defines the zero-based index of a specific track

In case the nIdRectangle parameter should be set to TRACKSBOARD_RECT_SINGLE_ITEM or TRACKSBOARD_RECT_SINGLE_VOLUME_POINT this parameter defines the unique identification number of the item.

In all other cases this parameter is ignored.

nIdSecond

In case the nIdRectangle parameter should be set to TRACKSBOARD_RECT_SINGLE_VOLUME_POINT this parameter defines the zero-based index of the volume point belonging to the item defined into the nIdFirst parameter.

In all other cases this parameter is ignored.

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