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

);

Constants

#define TEXT_MODIFY_FLAGS 1

#define TEXT_MODIFY_ZEICHENSCHLUESSEL 2

#define TEXT_MODIFY_SCHRAFFUR 4

#define TEXT_MODIFY_TEXTART 8

#define TEXT_MODIFY_TEXTHOEHE 16

#define TEXT_MODIFY_KOORDINATE 32

#define TEXT_MODIFY_WINKEL 64

#define TEXT_MODIFY_STANDLINIENLAENGE 128

#define TEXT_MODIFY_STANDLINIE 256

#define TEXT_MODIFY_TEXTMODE 512

#define TEXT_MODIFY_ID 1024

#define TEXT_MODIFY_COLORS 2048

#define TEXT_MODIFY_ALL 4095

Related functions

DBmodifyObjectSettings

DBmodifyPlanSettings

DBmodifyPointSettings

DBmodifyPointElementSettings

DBmodifySegmentSettings

DBmodifyStringSettings

DBmodifySymbolSettings

DBmodifyTextString