ReportObjects Collection

The ReportObjects Collection is a collection of report objects in a section. Report objects can be a field, text, ole, cross-tab, subreport, BLOB field, Box, Graph, or Line objects. Access a specific object in the collection using the Item property.

ReportObjects Collection Properties

Property	Description	Read/Write
Application	Returns a reference to the Application Object (page 290), that	Read only
	this object is associated with.
Count	Returns the number of report objects in the collection.	Read only
Item	Returns a report object. Depending on the type of item	Read only
	referenced, this can be a BlobFieldObject Object (page 297),
	FieldObject Object (page 315),TextObject Object (page 372),
	OLEObject Object (page 329), CrossTabObject Object (page
	299), SubreportObject Object (page 369), BoxObject Object
	(page 298), GraphObject Object (page 322), or a LineObject
	Object (page 329). Item has an index parameter that is a
	numeric, 1-based index (i.e., Item (1)). The items in the
	collection are indexed in the order they were added to the
	report.
Parent	Reference to the Parent object (Section Object (page 361)).	Read only
Report	Reference to Report Object (page 349).	Read only

Remarks

Instead of using the Item property as shown, you can reference a report object directly, for example, ReportOptions(1).

ReportOptions Object

The ReportOptions Object provides properties for manipulating the options available in the report.

Crystal Report Engine Object Model for the Automation Server

358

ReportOptions Object Properties

Property		Description		Read/Write
Application		Returns a reference to the Application Object (page		Read only
		290), this object is associated with.
CaseInsensitiveSQLData		Returns/Sets Boolean value indicating if SQL data		Read/Write
		is case-sensitive.
ConvertDateTimeToDate		Returns/Sets CRConvertDateTimeType (see table		Read/Write
		below) indicating what datetime fields are to be
		converted to (that is, string, time, no conversion,
		etc.).
		Constant	Value
		crConvertDateTimeToDate	1
		crConvertDateTimeToString	0
		crKeepDateTimeType	2
Property		Description		Read/Write
ConvertNullFieldToDefault		Returns/Sets Boolean value indicating if null		Read/Write
		database fields should be converted to the default
		value.
HasGroupTree		Returns/Sets Boolean value indicating if the		Read/Write
		preview window includes the Group Tree. You
		must also set the HasGroupTree property to TRUE
		in the PrintWindowOptions Object (page 347), to
		have the Group Tree show in the preview window.
MorePrintEngineErrorMessages		Returns/Sets Boolean value indicating if more print		Read/Write
		engine error messages are given at the report level.
		If they are on by default, you can turn this option
		off by using this property.
Parent		Reference to the Parent object (Report Object (page		Read only
		349)).
Report		Reference to Report Object (page 349).		Read only
SaveDataWithReport		Returns/Sets Boolean value indicating if data is		Read/Write
		saved with the report.
SaveSummariesWithReport		Returns/Sets Boolean value indicating if summary		Read/Write
		values (that is, group, report, cross-tab summaries)
		are to be saved with the report. You must also set
		SaveDataWithReport to TRUE.

Crystal Report Engine Object Model for the Automation Server

359