DBmodifyTextSettings

Top Previous Next

Text change.

With this routine the parametres of an existing text element can be changed. The parametres are delivered in a structure in which all fields must be filled which should be changed. Besides, single parametres can be selected, while only these are performed in the variables modifyFlags. Just all parametres can be changed, while in modifyFlags the constant TEXT_MODIFY_ALL is given. The constants of the single parametres can become geodert, so that, e.g., text kind and text height can be changed with a call. Then here is with modifyFlags the value

TEXT_MODIFY_TEXTART | TEXT_MODIFY_TEXTHOEHE

to brag. The structure is the same like with DBreturnTextSettings, so that first the topical settings can be changed questioned and then single ones and be written back. The text itself is changed with DBchangeTextString.

Parametre

element (PTEXT_ELEMENT) [IN]

This is the trading of the text element which should be changed.

modifyFlags (int) [IN]

For every quality to be changed of the text element 1 bit is put in these variables, or one of the constants TEXT_MODIFY _??? adds. If all qualities should be changed, the constant TEXT_MODIFY_ALL can be given instead of this.

settings (TEXT_SETTINGS *) [IN]

In this structure the data will hand over to the procedure. Only the data which are given in modifyFlags must be valid. The structure is identical with that who becomes with DBreturnTextSettings to handed over ones.

grade (int) [IN]

Possible values are 1 and 2.

With this routine only the value 1 is permitted, all the other values release an Assertion. The value 2 causes that in settings the Boundingbox of the text are still stored.

Result

(T_ERROR) [OUT]

ERROR_OK if everything was successful.

ERROR_PLAN_IS_WRITEPROTECTED

Declaration

#include "database.h"

void DLLENTRY DBmodifyTextSettings (

PTEXT_ELEMENT element,

int modifyFlags,

TEXT_SETTINGS * settings,

int grades

);