PrintDocument for WinForms | ComponentOne
C1.PrintDocument.4.8 Assembly / C1.C1Preview Namespace / RenderRichText Class / CalcSize Method
The width of the current object. This parameter may be specified as Unit.Auto or as an absolute value (but it must not reference other objects).
The height of the current object. This parameter may be specified as Unit.Auto or as an absolute value (but it must not reference other objects).

In This Topic
    CalcSize Method (RenderRichText)
    In This Topic
    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.
    Syntax
    'Declaration
     
    Public Function CalcSize( _
       ByVal width As Unit, _
       ByVal height As Unit _
    ) As SizeD
    public SizeD CalcSize( 
       Unit width,
       Unit height
    )

    Parameters

    width
    The width of the current object. This parameter may be specified as Unit.Auto or as an absolute value (but it must not reference other objects).
    height
    The height of the current object. This parameter may be specified as Unit.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. 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 C1PrintDocument.AvailableBlockFlowHeight): 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();
    Example
    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 C1PrintDocument.AvailableBlockFlowHeight):
    See Also