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

# XmFontListEntryCreate(3)

A font list function that creates a font list entry

## NAME

**XmFontListEntryCreate** — A font list function that creates a font list entry

## SYNOPSIS

```
#include <Xm/Xm.h>
XmFontListEntry XmFontListEntryCreate(
char *tag,
XmFontType type,
XtPointer font);
```

## DESCRIPTION

**XmFontListEntryCreate** creates a font list entry that contains either a font or font set and is identified by a tag.

- *tag*

  Specifies a NULL terminated string for the tag of the font list entry. The tag may be specified as **XmFONTLIST\_DEFAULT\_TAG**, which is used to identify the default font list element in a font list.

- *type*

  Specifies whether the *font* argument is a font structure or a font set. Valid values are **XmFONT\_IS\_FONT** and **XmFONT\_IS\_FONTSET**.

- *font*

  Specifies either an **XFontSet** returned by **XCreateFontSet** or a pointer to an **XFontStruct** returned by **XLoadQueryFont**.

The toolkit does not copy the X Font structure specified by the *font* argument. Therefore, an application programmer must not free **XFontStruct** or **XFontSet** until all font lists and/or font entries that reference it have been freed.

## RETURN

Returns a font list entry. The function allocates space to hold the returned font list entry. The application is responsible for managing the allocated space. The application can recover the allocated space by calling **XmFontListEntryFree**.

## RELATED

[**XmFontList**(3)](/XmFontList/3.md), [**XmFontListAppendEntry**(3)](/XmFontListAppendEntry/3.md), [**XmFontListEntryFree**(3)](/XmFontListEntryFree/3.md), [**XmFontListEntryGetFont**(3)](/XmFontListEntryGetFont/3.md), [**XmFontListEntryGetTag**(3)](/XmFontListEntryGetTag/3.md), [**XmFontListEntryLoad**(3)](/XmFontListEntryLoad/3.md), and [**XmFontListRemoveEntry**(3)](/XmFontListRemoveEntry/3.md).