Report. TextHeight-Methode (Access)Report.TextHeight method (Access)

Die TextHeight -Methode gibt die Höhe einer Textzeichenfolge so zurück, wie Sie in der aktuellen Schriftart eines Report -Objekts gedruckt würde.The TextHeight method returns the height of a text string as it would be printed in the current font of a Report object.

SyntaxSyntax

Ausdruck. TextHeight (Expr)expression.TextHeight (Expr)

Ausdruck Eine Variable, die ein Report -Objekt darstellt.expression A variable that represents a Report object.

ParameterParameters

NameName Erforderlich/OptionalRequired/Optional DatentypData type BeschreibungDescription
ExprExpr ErforderlichRequired StringString Die Textzeichenfolge, für die die Texthöhe bestimmt wird.The text string for which the text height will be determined.

RückgabewertReturn value

SingleSingle

HinweiseRemarks

Sie können die TextHeight -Methode verwenden, um die Größe des vertikalen Speicherplatzes zu bestimmen, den eine Textzeichenfolge in der aktuellen Schriftart benötigt, wenn der Bericht formatiert und gedruckt wird.You can use the TextHeight method to determine the amount of vertical space that a text string will require in the current font when the report is formatted and printed. Eine Textzeichenfolge, die z.  B. in Arial mit 9 Punkt formatiert ist, benötigt eine andere Breite als eine in Courier mit 12 Punkt formatierte Textzeichenfolge.For example, a text string formatted in 9-point Arial will require a different amount of space than one formatted in 12-point Courier. Um die aktuelle Schriftart und den Schriftgrad für Text in einem Bericht zu bestimmen, überprüfen Sie die Einstellungen **** für die Eigenschaften FontName und FontSize des Berichts.To determine the current font and font size for text in a report, check the settings for the report's FontName and FontSize properties.

Der von der TextHeight **** -Methode zurückgegebene Wert wird gemäß der Definition durch die Scale -Methode in Bezug auf das für den Bericht geltende Koordinatensystem ausgedrückt.The value returned by the TextHeight method is expressed in terms of the coordinate system in effect for the report, as defined by the Scale method. Sie können die ScaleMode -Eigenschaft verwenden, um das derzeit für den Bericht geltende Koordinatensystem zu bestimmen.You can use the ScaleMode property to determine the coordinate system currently in effect for the report.

Wenn das Zeichenfolgenausdruck -Argument eingebettete Wagenrückgabe Zeichen enthält **** , gibt die TextHeight-Methode die kumulative Höhe der Zeilen zurück, einschließlich des führenden Leerraums oberhalb und unterhalb jeder Zeile.If the StrExpr argument contains embedded carriage returns, the TextHeight method returns the cumulative height of the lines, including the leading space above and below each line. Sie können den von der TextHeightTextHeight-Methode zurückgegebenen Wert verwenden, um den erforderlichen Platz zu berechnen, wenn mehrere Textzeilen innerhalb eines Berichts zu positionieren sind.You can use the value returned by the TextHeight method to calculate the necessary space and positioning for multiple lines of text within a report.

BeispielExample

Das folgende Beispiel verwendet die Methoden TextHeightTextHeight und TextWidthTextWidth, um die Höhe und die Breite des Bereichs zu ermitteln, der zum Drucken einer Textzeichenfolge in der aktuellen Schriftart des Berichts benötigt wird.The following example uses the TextHeight and TextWidth methods to determine the amount of vertical and horizontal space required to print a text string in the report's current font.

Zum Testen dieses Beispiels in Microsoft Access erstellen Sie einen neuen Bericht.To try this example in Microsoft Access, create a new report. Legen Sie die OnPrintOnPrint-Eigenschaft des Detailbereichs auf [Ereignisprozedur] fest.Set the OnPrint property of the Detail section to [Event Procedure]. Geben Sie den folgenden Code in das Modul des Berichts ein, und wechseln Sie dann zur Seitenansicht.Enter the following code in the report's module, and then switch to Print Preview.

Private Sub Detail_Print(Cancel As Integer, _ 
 PrintCount As Integer) 
 ' Set unit of measure to twips (default scale). 
 Me.Scalemode = 1 
 ' Print name and font size of report font. 
 Debug.Print "Report Font: "; Me.FontName 
 Debug.Print "Report Font Size: "; Me.FontSize 
 ' Print height and width required for text string. 
 Debug.Print "Text Height (Twips): "; _ 
 Me.TextHeight("Product Report") 
 Debug.Print "Text Width (Twips): "; _ 
 Me.TextWidth("Product Report") 
End Sub

Support und FeedbackSupport and feedback

Haben Sie Fragen oder Feedback zu Office VBA oder zu dieser Dokumentation?Have questions or feedback about Office VBA or this documentation? Unter Office VBA-Support und Feedback finden Sie Hilfestellung zu den Möglichkeiten, wie Sie Support erhalten und Feedback abgeben können.Please see Office VBA support and feedback for guidance about the ways you can receive support and provide feedback.