abmCellsGetCellUniqueID function

Return to index

abmCellsGetCellUniqueID function

Remarks

Given an index, returns the corresponding cell's UniqueID.

When used in conjunction with the abmCellsGetCount function, it can enumerate the UniqueID of the available cells.

Further information about cells management can be found inside the How to manage cells section.

Return value

Value	Meaning

-1	The operation failed
value >= 0	The UniqueID for the requested cell

Syntax

short abmCellsGetCellUniqueID (

HWND hWndBtn,

short nPosition

);

Parameters	Description
hWndBtn	Windows handle associated to the button.
nPosition	Index, inside the list of available cells, of the cell whose UniqueID must be retrieved.

Visual Basic example

Dim UniqueID As Integer

For i = 0 To abmCellsGetCount(Command1.hWnd) - 1

UniqueID = abmCellsGetCellUniqueID(Command1.hWnd, i)

Debug.Print UniqueID

Visual C++ example

HWND hWndBtn = GetDlgItem (IDC_BUTTON)->GetSafeHwnd ();

for (int i = 0; i < abmCellsGetCount(hWndBtn); i++)

nUniqueID = abmCellsGetCellUniqueID(hWndBtn, i);

TRACE1 ("Found cell with ID: %d\n\r", nUniqueID);