C# SDK

◆ OnMenuCommand()

static int OnMenuCommand ( out SError  Error,
int  nID,
int  nSubID,
bool  bShowApplication,
Int32  MaxTime 
)
inlinestatic

The function provides direct access to menu items.

Parameters
ErrorAdditional error information returned from Drive.
nIDMenu ID to which function provides access. Possible values are enumerated in CApplicationMenu.ID enum.
Name of most of CApplicationMenu.ID items is similar to name of menu displayed in screen top left corner. It is also similar to button name in main menu which opens corresponding menu.
bShowApplicationFlag determining whether Drive should be brought to foreground automatically.
true - Drive will be brought to foreground
false - Drive will stay in background
nSubIDMenu SubID corresponding to menu ID.
Name of most of SubID items is similar to name of correspondig button in corresponding menu (nID).
OnMenuCommand function calls function which is called after clicking this button.
Links to possible enums are listed in CApplicationMenu.ID.

For example: if nID = CApplicationMenu.ID.IdMenuManagePoi nSubID must be chosen from CApplicationMenu.IdMenuManagePoi enum.
MaxTimeMaximum time (in milliseconds) function can take. If MaxTime=0 function execution is not time limited.
Returns
1 if successful, other value otherwise.



Possible error codes returned from Drive are:

  • 0 - Function not succeeded.
  • 1 - Function succeeded.
  • 2 - Drive not succeeded.
  • 3 - Function reached timeout.



SError error;
int nID = CApplicationMenu.ID.IdMenuMain;
int nSubID = CApplicationMenu.IdMenuMain.OnMainNavigateTo;
bool bShowApplication = true;
int nMaxTime = 10000;
CApplicationAPI.OnMenuCommand(out error, nID, nSubID, bShowApplication, nMaxTime);

This code brings Drive to foreground and shows NavigateTo menu:

References SError.SizeOf().