---
name: "mface_put_prop"
section: "3m17n"
platform: "linux"
package: "m17n-docs"
version: "1.8.4-1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/mface_put_prop"
---

# mface\_put\_prop(3m17n)

## NAME

mface\_put\_prop -

## SYNOPSIS

int **mface\_put\_prop** (**MFace** \* *face*, MSymbol *key*, void \* *val*)

## DESCRIPTION

Set a value of a face property. The **mface\_put\_prop()** function assigns **val** to the property whose key is **key** in face **face**. **key** must be one the followings:

```
#Mforeground, #Mbackground, #Mvideomode, #Mhline, #Mbox,
#Mfoundry, #Mfamily, #Mweight, #Mstyle, #Mstretch, #Madstyle,
#Msize, #Mfontset, #Mratio, #Mhook_func, #Mhook_arg
```

 Among them, font related properties (**Mfoundry** through **Msize**) are used as the default values when a font in the fontset of **face** does not specify those values.

The actual type of the returned value depends of **key**. See documentation of the above keys.

## RETURN VALUE

If the operation was successful, **mface\_put\_prop()** returns 0. Otherwise it returns -1 and assigns an error code to the external variable **merror\_code**. \

## SEE ALSO

**mface\_get\_prop()**

## ERRORS

`MERROR_FACE`\

## COPYRIGHT

Copyright (C) 2001 Information-technology Promotion Agency (IPA)\
 Copyright (C) 2001-2011 National Institute of Advanced Industrial Science and Technology (AIST)\
 Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License  \<http://www.gnu.org/licenses/fdl.html\>.