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.