SOPutBreak

Sets a paragraph, cell, record, page, section, or other type of break.

In spreadsheet sections, the last cell in a section must have an associated SO_CELLBREAK break before the SO_SECTIONBREAK or SO_EOFBREAK break.

In database sections, the last record in a section must have an associated SO_RECORDBREAK break before the SO_SECTIONBREAK or SO_EOFBREAK break.

In word processing sections, the last paragraph does not need an SO_PARABREAK break before the SO_SECTIONBREAK or SO_EOFBREAK break.

WORD SOPutBreak(

    WORD wType,

 

    DWORD dwInfo,

 

    HPROC reserved

 

   );

 

 

Parameters

wType

Type of break. This parameter can one of these values:

SO_CELLBREAK

Regular cell break

SO_EOFBREAK

End of file (EOF) break, which implies a section break

SO_PARABREAK

Regular paragraph break

SO_RECORDBREAK

Regular record break

SO_SECTIONBREAK

Section break

SO_SUBDOCBEGINBREAK

Subdocument s begin break

SO_SUBDOCENDBREAK

Subdocument s end break

 

dwInfo

Data to save for each record. This data is for database section breaks. For all other section types, this parameter should be zero.

dwInfo is saved after every SOPutBreak function and, like the regular save information, should represent the next record, not the one just read.

reserved

Reserved; do not use.

 

Return Values

Returns the SO_STOP value to direct the file parser to stop processing and return or the SO_CONTINUE value to direct the file parser to continue processing.