textHeightSum

returns the total height of the text in a field or button.

# Metadata

Platforms: desktop, server, mobile OS: ios, android Introduced: 1.0 Security:

# Syntax

the textHeightSum of object

# Params

- object : A field, button, card, or group.

# Examples

the textHeightSum of field "Comments"

if the textHeightSum of group 1 > the height of this card then expandCd

# Description

Use the textHeightSum function to determine how much vertical space a field or button text requires.

This function exists for compatibility with imported SuperCard projects. You can use the formattedHeight property to find the height of the text in a field or button.

If the object is a button or field, the textHeightSum returns the number of vertical pixels needed to display all the text at the field current width. If the object is a card or group, the textHeightSum returns the number of vertical pixels needed to display all the objects in the card or group.

# Tags

ui,

# See

- **keyword:** button, integer, field, card - **property:** formattedWidth, textHeight, formattedHeight, pixels, pageHeights - **command:** group - **object:** field, button - **glossary:** object, property, return - **control structure:** function