C++ Syntax

bool

MKI_DialogCollectionHandleBlock(

HWND f_hWindow,

__int32 f_nCtlID,

const LPCWSTR f_pszLibraryIn,

const LPCWSTR f_pszBlockIn,

MKI_LIBRARYNAME* f_pLibraryOut,

MKI_BLOCKNAME* f_pBlockOut );

Displays a context menu for handling block names in the pinboard and the collections. It enables the user to add a given block name (with library name) to the pinboard or a collection, or to get a block name (with library name) from the pinboard or a collection.

Parameters

Window

[HWND] Handle of the dialog window whose control was clicked.

CtlID

[__int32] ID of the control that was clicked (only used to position the context menu).

LibraryIn

[const LPCWSTR] Current library name that can be stored. May be nullptr if nothing can be stored, the corresponding menu items will be disabled.

BlockIn

[const LPCWSTR] Current block name that can be stored. May be nullptr if nothing can be stored, the corresponding menu items will be disabled.

LibraryOut

[MKI_LIBRARYNAME*] Library name chosen by the user. May be nullptr if nothing can be chosen, the corresponding menu items will be disabled.

BlockOut

[MKI_BLOCKNAME*] Block name chosen by the user. May be nullptr if nothing can be chosen, the corresponding menu items will be disabled.

Return Value

Returns true if the user chose an item from the pinboard or a collection, the resulting data was stored in LibraryOut and BlockOut.