XLL+ Class Library (6.3)

::XlReadGroupedScalarEx

Transform one item in a grouped CXlOper into a single value of an extended type

template< class T, class XLT >
void XlReadGroupedScalarEx(
   const CXlOper& xlo,
   T& value,
   const CXlUserConverterBase<T, XLT>& outerConverter,
   const wchar_t* groupName,
   unsigned long index,
   const wchar_t* argName,
   unsigned long flags = 0,
   const T& defaultValue = T()
);

Parameters

xlo

A reference to the input passed by Excel. This will contain all members of the group.

value

A reference to a variable into which the result will placed, if the conversion is successful.

outerConverter

An instance of the extended type's converter class. See CXlUserConverterBase for details.

groupName

The name of the Excel argument that contains the group. This will be used in error messages.

index

The index of the item within the group.

argName

The name of the item within the group that is being converted. This will be used in error messages, and may also be used to search the grouped input.

flags

A set of flags that control the conversion. See Conversion functions for a list of values.

defaultValue

The default value that will be used for an optional argument, if the argument is omitted by the user.

Remarks

If the function fails for any reason, an exception of type CXlConversionException is thrown. This will be caught by the outer wrapper function, and converted into an appropriate form to be returned to Excel.

Requirements

Header: xlpconvert.h

See Also

Global conversion functions