NAME

mtext_put_prop -

SYNOPSIS

int mtext_put_prop (MText * mt, int from, int to, MSymbol key, void * val)

DESCRIPTION

@brief Set a text property.
The mtext_put_prop() function sets a text property to the
characters between @b from (inclusive) and @b to (exclusive) in M-text
@b mt.  @b key and @b val specify the key and the value of the text
property.  With this function,

                     FROM                   TO
M-text: |<------------|-------- MT ---------|------------>|
PROP  :  <------------------ OLD_VAL -------------------->

becomes

                     FROM                   TO
M-text: |<------------|-------- MT ---------|------------>|
PROP  :  <-- OLD_VAL-><-------- VAL -------><-- OLD_VAL-->

@par Return value:
If the operation was successful, mtext_put_prop() returns 0.
Otherwise it returns -1 and assigns an error code to the external
variable #merror_code.   
@par Errors:
@c MERROR_RANGE, @c MERROR_SYMBOL
@par See Also:
mtext_put_prop_values(), mtext_get_prop(),
mtext_get_prop_values(), mtext_push_prop(),
mtext_pop_prop(), mtext_prop_range()   

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>.