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

# XmChangeColor(3)

Recalculates all associated colors of a widget

## NAME

**XmChangeColor** — Recalculates all associated colors of a widget

## SYNOPSIS

```
#include <Xm/Xm.h>
void XmChangeColor(
Widget widget,
Pixel background);
```

## DESCRIPTION

**XmChangeColor** handles all color modifications for the specified widget when a new background pixel value is specified. This function recalculates the foreground, select, and shadow colors based on the new background color and sets the corresponding resources for the widget. If a color calculation procedure has been set by a call to **XmSetColorCalculation**, **XmChangeColor** uses that procedure to calculate the new colors. Otherwise, the routine uses a default procedure.

- *widget*

  Specifies the widget ID whose colors will be updated

- *background*

  Specifies the background color pixel value

## RELATED

[**XmGetColorCalculation**(3)](/XmGetColorCalculation/3.md), [**XmGetColors**(3)](/XmGetColors/3.md), and [**XmSetColorCalculation**(3)](/XmSetColorCalculation/3.md).