db_get_text_attribute()

Returns a text attribute, an integer code for the kind of text. Normal text is simple free standing text, not associated with components/instances. Annotation text is associated with an instance and is used to display the instance's name, design name and parameters. You must retrieve an instance's mask record to obtain access to these types of text strings. The TEXT_JUST field retrieves an "or'd" integer representing the text justification.

Syntax:

db_get_text_attribute(textHandle, textAttribute);

where

textHandle is a handle to a text, as returned from db_get_dg_attribute().

textAttribute is the text attribute, where:

• TEXT_TYPE = Type of text; returns one of these types:
  • NORMAL_TEXT
  • ANNOT_DESIGN_NAME
  • ANNOT_INST_NAME
  • ANNOT_INST_PARAMETER
• TEXT_FONT = Font number
• TEXT_FONT_NAME = Font name
• TEXT_HEIGHT = Height of the text in user units
• TEXT_JUST= Text justification, an "or'd" combination of one or more of these:
  • DB_BOT_JUST
  • DB_MID_JUST
  • DB_TOP_JUST with one of these:
    • DB_LEFT_JUST
    • DB_CENTER_JUST
    • DB_RIGHT_JUST
• TEXT_ABSOLUTE = Flag indicating whether the text can rotate
• TEXT_LOCATION = Location handle: x,y and angle
• TEXT_PARAM_SEQ_NO = Parameter index indicating which parameter
• TEXT_STRING = Actual text string

Example:

if (db_get_dg_attribute(dgHandle, DG_TYPE)==TEXT_DG_TYPE)
{
    decl textHandle = db_get_dg_attribute(dgHandle, DG_DATA);
    decl textHt = db_get_text_attribute(textHandle, TEXT_HEIGHT);
}

Where Used:

Schematic, Layout