Site Tools


documentation:development:opera:pf25:ppgfldr:smmfldr:ldofldr:01ldo178

taModifyTextCel

Changes text cel attributes from tag args.

Synopsis

TextCel * taModifyTextCel (TextCel *tCel, TagArg *tags)

Description

Changes attributes already in a text cel. You can set all configurable attributes of the text cel by specifying appropriate tags and values. If you include TCEL_TAG_UPDATE_TEXT_STRING in the tags, the specified text is rendered into the cel after processing all other tags.

A negative return value is possible when the text cel size or format buffer attributes are changed and a memory allocation failure occurs. A positive non-zero return value is possible if TCEL_TAG_UPDATE_TEXT_STRING is specified and characters are clipped. Otherwise, the return value is zero.

Arguments

  • tCel Pointer to a TextCel structure.
  • tags Pointer to an array of tags and associated values.

Return Value

Negative on error, non-negative if successful.

Associated Files

lib3do.lib, textlib.h

See Also

SetTextCel...() functions

documentation/development/opera/pf25/ppgfldr/smmfldr/ldofldr/01ldo178.txt · Last modified: 2022/10/10 16:53 by 127.0.0.1