Calculates the size of the current object. When this method is called, the object must already have been added to the document (e.g. to Body or to Children of another object in the document). See remarks for more details.

Namespace:  C1.C1Preview
Assembly:  C1.C1Report.2 (in C1.C1Report.2.dll)

Syntax

C#
public SizeD CalcSize(
	Unit width,
	Unit height
)
Visual Basic
Public Function CalcSize ( _
	width As Unit, _
	height As Unit _
) As SizeD

Parameters

width
Type: C1.C1Preview..::..Unit
The width of the current object. This parameter may be specified as Auto or as an absolute value (but it must not reference other objects).
height
Type: C1.C1Preview..::..Unit
The height of the current object. This parameter may be specified as Auto or as an absolute value (but it must not reference other objects).

Return Value

The size of the current object, in ResolvedUnit units.

Remarks

If the current object has not been added to the document, an exception is thrown. (This is because to calculate the size of an object, its style is needed, and due to style inheritance, the effective style of an object depends on the placement of that object within the document.) The object may be removed from the document after calling this method if desired.

Examples

The following C# code may be used to test whether a RenderText will fit on the current page if inserted at the current block flow position (see AvailableBlockFlowHeight):
Copy CodeC#
C1PrintDocument doc = new C1PrintDocument();
doc.StartDoc();
RenderText rt = new RenderText("The text to measure.);
// add the object temporarily to calculate its size:
doc.Body.Children.Add(rt);
// measure the object, specifying page width and auto heigh
// (i.e. effectively, measure the text height):
C1PageSettings ps = doc.PageLayout.PageSettings;
double pageWidth = ps.Width.Value - ps.LeftMargin.Value - ps.RightMargin.Value;
SizeD sz = rt.CalcSize(new Unit(pageWidth, ps.Width.Units), Unit.Auto);
// remove the object added temporarily:
doc.Body.Children.Remove(rt);
// test whether the object would fit on the page:
if (doc.AvailableBlockFlowHeight >= sz.Height)
{
    // object would fit, do something:
    doc.RenderBlockText("YES");
}
doc.EndDoc();

See Also