DBmodifyTextSettings

Text ändern.

Mit dieser Routine können die Parameter eines existierenden Textelements geändert werden. Die Parameter werden in einer Struktur eingeliefert, in der alle Felder ausgefüllt werden müssen, die verändert werden sollen. Es können dabei einzelne Parameter ausgewählt werden, indem nur diese in der Variablen modifyFlags aufgeführt werden. Genauso können alle Parameter geändert werden, indem in modifyFlags die Konstante TEXT_MODIFY_ALL angegeben wird. Die Konstanten der einzelnen Parameter können geodert werden, so dass z.B. Textart und Texthöhe mit einem Aufruf geändert werden können. Hier ist dann bei modifyFlags der Wert

TEXT_MODIFY_TEXTART | TEXT_MODIFY_TEXTHOEHE

anzugeben. Die Struktur ist dieselbe wie bei DBreturnTextSettings, so dass zuerst die aktuellen Einstellungen abgefragt und dann einzelne geändert und zurückgeschrieben werden können. Der Text selber wird mit DBchangeTextString verändert.

Parameter

element (PTEXT_ELEMENT)                   [IN]

Dies ist das Handle des Textelements, das verändert werden soll.

modifyFlags (int)                                         [IN]

Für jede zu ändernde Eigenschaft des Textelements wird in dieser Variablen ein Bit gesetzt, bzw. eine der Konstanten TEXT_MODIFY_??? addiert. Wenn alle Eigenschaften geändert werden sollen, kann statt dessen die Konstante TEXT_MODIFY_ALL angegeben werden.

settings (TEXT_SETTINGS *)                   [IN]

In dieser Struktur werden die Daten an die Prozedur übergeben. Es müssen nur die Daten gültig sein, die in modifyFlags angegeben sind. Die Struktur ist identisch mit der, die bei DBreturnTextSettings übergebenen wird.

stufe (int)                                                      [IN]

Mögliche Werte sind 1 und 2.

Bei dieser Routine ist nur der Wert 1 erlaubt, alle anderen Werte lösen eine Assertion aus. Der Wert 2 bewirkt, dass in settings die Boundingbox des Textes noch gespeichert wird.

Ergebnis

(T_ERROR)                                            [OUT]

ERROR_OK, wenn alles erfolgreich war.

ERROR_PLAN_IS_WRITEPROTECTED

Deklaration

#include "database.h"

void DLLENTRY DBmodifyTextSettings(

     PTEXT_ELEMENT     element,

     int               modifyFlags,

     TEXT_SETTINGS *   settings,

     int               stufe

);

Konstanten

#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

Verwandte Funktionen

DBmodifyObjectSettings

DBmodifyPlanSettings

DBmodifyPointSettings

DBmodifyPointElementSettings

DBmodifySegmentSettings

DBmodifyStringSettings

DBmodifySymbolSettings

DBmodifyTextString