This function is called during assembly when the end user clicks the Select button on a Spreadsheet dialog. The implementation of this entry point should display (or cause to be displayed) a modal dialog box where the user can browse, search, filter, or otherwise review information made available by the answer source application. When the user chooses one or more records containing the data, the implementation should close the modal dialog box and return the number of records selected.
This function was introduced with the release of HotDocs 2005 SP2. Earlier versions of HotDocs will not call this function. On Regular and Repeated Series dialogs, the ChooseRecord function is called instead of ChooseMultipleRecords.
long ChooseMultipleRecords ( )
Return the number of records selected. (If the user cancels the dialog without selecting records, the function should return zero (0).) This value is used to calculate the size of the buffer passed to GetChosenRecords.
The following Visual C++ example displays a MessageBox where the user can choose to either select two (2) or zero (0) records:
long WINAPI ChooseMultipleRecords()
{
long nResult = MessageBox(NULL, "Do you want to choose two records? If you click no, you will be choosing zero records.", "ChooseMultipleRecords", MB_YESNO);
if (nResult == IDYES)
return 2;
else
return 0;
}