DBnewDisplayString

This call generates a new string element in the data bank which is always indicated.

Ordinarily are indicated element of the data bank exactly when the objects to which they belong are selected. An exception form the objects and with it elements which are put on in the segment with the ID 65535 (if this segment exists). All these objects are always indicated. Otherwise can be worked with this segment normally. Objects from this segment cannot be only selected. Now with the procedure DBnewDisplayString this segment 65535 is put on, if it does not exist yet. Then an object is generated in this segment and is generated in this object a string element. The trading of this string element is returned as a result. If a mistake appears, this becomes instead of this zero-acts as a result delivered.

Parametre

root (PROOT) [IN]

The trading of the data bank.

zeichenSchluessel (int) [IN]

With this value the lines are drawn. He corresponds about to one sign colour.

schraffur (int) [IN]

If this value 0 is, it concerns with the string a line train. But it is a surface with the filling pattern schraffur.

Result

(PSTRING_ELEMENT) [OUT]

The trading of the new string element. It can be used up to selecting the accompanying object as a normal element.

Declaration

#include "database.h"

PSTRING_ELEMENT DLLENTRY DBnewDisplayString (

PROOT root,

int zeichenSchluessel,

int schraffur

);