COM objects > MidiDjConsole object > Methods > MidiDjConsole.ProfileItemModify method

Remarks

Modifies an existing item contained inside the profile of the DJ Console.

For further details about interfacing with MIDI DJ Consoles see the MidiDjConsole object section and the How to manage MIDI DJ consoles tutorial.

Syntax

[Visual Basic]

control.MidiDjConsole.ProfileItemModify (

strItemName as String,

nItemType as enumDjConsoleItemType,

strItemDescr as String,

strItemTag as String

) as enumDjcErrorCodes

[C++]

short control.MidiDjConsole.ProfileItemModify (

BSTR strItemName,

short nItemType,

BSTR strItemDescr,

BSTR strItemTag

);

Parameter

Description

strItemName

String containing the name of the item to modify.

If no item with this specific name should be available inside the profile, the method would fail and would return an error code.

The item's name is UNICODE compliant so can support languages using the double-byte convention.

nItemType

Specifies the type of the item.

Supported values are the following:

Mnemonic constant	Value	Meaning
DJC_ITEM_TYPE_BUTTON	0	Simple push button control
DJC_ITEM_TYPE_BUTTON_WITH_LED	1	Push button control with an embedded led driven by the same MIDI command. The usage of this type is not mandatory when the push button and its led have the same MIDI command; if you want you can keep the push button separated from its led inside the profile.
DJC_ITEM_TYPE_RANGE	2	Range control: sliders, rotary knobs and jog wheels are included in this category.
DJC_ITEM_TYPE_LED	3	Led control or VFD (Vacuum Fluorescent Display) symbol driven as a led.
DJC_ITEM_TYPE_DISPLAY	4	VFD (Vacuum Fluorescent Display) element not driven as a simple led, for example the track number or the position of the track.

strItemDescr

String containing the friendly description of the item.

strItemTag

String containing the tag string of the item. You can use this string to assign a custom behaviour to the item of the profile without affecting any of its other settings or causing side effects.

Return value

Value	Meaning

enumDjcErrorCodes.ERR_DJC_NOERROR (0)	The call was successful.
Negative value	An error occurred: see the LastError property for further error details or for a list of the possible error values.