aglName

Places a specified string onto the title bar of an Array Viewer instance.

int aglName(
  pvoid array,
  const char *name
  );

Parameters

array

A pointer to an array either allocated by means of a call to aglAlloc, aglMalloc, or aglMallocEx, or added to the watch list by means of a call to aglStartWatch.

name

The string of characters to be placed in the title bar.

Return Value

Returns the value 0 if the call is successful; any other value indicates failure.

Remarks

If the Array Viewer instance associated with array was created by using the CAViewer class, rather than aglShow, this routine will have no effect. Use the CAViewer::SetArrayName method instead.

See Also

aglAlloc, aglMalloc, aglStartWatch