---
name: "XmTextGetTopCharacter"
section: "3"
platform: "linux"
package: "openmotif"
version: "2.3.8-4"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/XmTextGetTopCharacter"
---

# XmTextGetTopCharacter(3)

A Text function that accesses the position of the first character displayed

## NAME

**XmTextGetTopCharacter** — A Text function that accesses the position of the first character displayed

## SYNOPSIS

```
#include <Xm/Text.h>
XmTextPosition XmTextGetTopCharacter(
Widget widget);
```

## DESCRIPTION

**XmTextGetTopCharacter** accesses the position of the text at the top of the Text widget. If there is no text in the Text widget (in other words, **XmNvalue** contains an empty string), then **XmTextGetTopCharacter** returns 0.

Suppose that the **XmNtopCharacter** resource has been set to a value greater than the number of characters in the text widget. In this case, **XmTextGetTopCharacter** returns an **XmTextPosition** value identifying the position of the first character in the last line of text in a multiline case; otherwise, it identifies the position of the last character in the line.

- *widget*

  Specifies the Text widget ID

For a complete definition of Text and its associated resources, see [**XmText**(3)](/XmText/3.md).

## RETURN

Returns an **XmTextPosition** value that indicates the state of the **XmNtopCharacter** resource. This is an integer number of characters from the beginning of the text buffer. The first character position is 0 (zero).

## RELATED

[**XmText**(3)](/XmText/3.md).