Parameters

Property Description

b1	Specifies whether the option is selected (TRUE)

Area Object

The Area Object represents an area in a report. An area is a group of like sections in the report (i.e., Details A - Da, Details B - Db, etc.) that all share the same characteristics. Each section within the area can be formatted differently. This object allows you to retrieve information and set options for a specified area in your report.

Area Object Properties

	Property	Description	Read/Write	Restriction in event
				handler
	CopiesToPrint	Returns/Sets the number of copies of	Read/Write	Can be written only when
		each item in the Details section of the		formatting idle.
		report. For example, by default, each
		line of the Details section only prints
		once. By setting this to 3, each line of
		the Details section would print 3
		times.
	DetailHeight	Returns the detail height of the current	Read only	None
		area in a mailing label report.
	DetailWidth	Returns the detail width in a multiple	Read only	None
		column report.
	DiscardOther	Returns/Sets the discard other groups	Read/Write
	Groups	option.
	GroupCondition	Returns or sets the group condition.	Read/Write	Can be written only when
				formatting idle.
	GroupCondition	Returns or sets the group condition	Read/Write	Can be written only when
	Field	field.		formatting idle.
	GroupNumber	If the area is a group, this returns the	Read only	None
		group number. Otherwise, exception is
		thrown.
	HideFor	Returns or sets hide for drill down	Read/Write	Can be written only when
	DrillDown	option.		formatting idle.

Report Designer Component Object Model

22

	Property	Description	Read/Write	Restriction in event
				handler
	HorizontalGap	Returns the horizontal gaps going	Read only	None
		across page breaks in a multiple
		column report.
	KeepGroup	Returns or sets keeping group	Read/Write	Can be written only when
	Together	together option.		formatting idle.
	KeepTogether	Returns or sets keeping area together	Read/Write	Can be written only when
		option.		formatting idle.
	Kind	Returns CRAreaKind (see table below)	Read only	None
		which specifies what “kind” of area
		(i.e., Details, Report Header, Page
		Footer, etc.).

Constant	Value
crDetail	4
crGroupFooter	5
crGroupHeader	3
crPageFooter	7
crPageHeader	2
crReportFooter	8
crReportHeader	1

Property	Description	Read/Write	Restriction in event handler
Name	Returns or sets area name.	Read/Write	None
NewPageAfter	Returns or sets new page after	Read/Write	Can be written only when
	options.		formatting idle.
NewPageBefore	Returns or sets new page	Read/Write	Can be written only when
	before option.		formatting idle.
NumberOfTop	Returns/Sets the number of	Read/Write
OrBottomN	top or bottom groups.
Groups
Parent	Reference to the Parent object	Read/Write	None
	(Area Object (page 22)).
PrintAtBottom	Returns or sets printing at	Read/Write	Can be written only when
OfPage	bottom of page option.		formatting idle.
RepeatGroup	Returns or sets repeating	Read/Write	Can be written only when
Header	group header option.		formatting idle.

Report Designer Component Object Model

23