Creates a single line of text.
Syntax: |
|
DlxLayer.DrawText(insertionPoint, text, rotationAngle = 0, alignment = DlxApp.TEXTALIGN_DEFAULT, flags = 0)
|
Parameters
| Parameter |
Description |
| insertionPoint |
A DlxPoint object with the coordinates where the text is placed. |
| text |
The text string. To insert overlined characters in the text, they must be delimited with the '|' character. |
| rotationAngle |
The angle, in degrees, of rotation of the text with respect to the x-axis. |
| alignment |
Specifies the horizontal and vertical alignment of the text with respect to the insertion point.
Enter the following values:
| Vertical |
| DlxApp.TEXTALIGN_TOP |
| DlxApp.TEXTALIGN_MIDDLE |
| DlxApp.TEXTALIGN_BASE |
| DlxApp.TEXTALIGN_BOTTOM |
| Horizontal |
| DlxApp.TEXTALIGN_LEFT |
| DlxApp.TEXTALIGN_CENTER |
| DlxApp.TEXTALIGN_RIGHT |
| DlxApp.TEXTALIGN_COMMA |
| DlxApp.TEXTALIGN_JUSTIFY |
| Vertical & Horizontal |
| DlxApp.TEXTALIGN_TOPLEFT |
| DlxApp.TEXTALIGN_TOPCENTER |
| DlxApp.TEXTALIGN_TOPRIGHT |
| DlxApp.TEXTALIGN_TOPJUSTIFY |
| DlxApp.TEXTALIGN_MIDDLELEFT |
| DlxApp.TEXTALIGN_MIDDLECENTER |
| DlxApp.TEXTALIGN_MIDDLERIGHT |
| DlxApp.TEXTALIGN_MIDDLEJUSTIFY |
| DlxApp.TEXTALIGN_BASELEFT |
| DlxApp.TEXTALIGN_BASECENTER |
| DlxApp.TEXTALIGN_BASERIGHT |
| DlxApp.TEXTALIGN_BASEJUSTIFY |
| DlxApp.TEXTALIGN_BOTTOMLEFT |
| DlxApp.TEXTALIGN_BOTTOMCENTER |
| DlxApp.TEXTALIGN_BOTTOMRIGHT |
| DlxApp.TEXTALIGN_BOTTOMJUSTIFY |
| Current alignment |
| DlxApp.TEXTALIGN_DEFAULT |
|
| flags |
Enter a combination of the following values:
| DlxApp.TEXTFLAGS_MIRRORX |
| DlxApp.TEXTFLAGS_MIRRORY |
| DlxApp.TEXTFLAGS_NEGATIVEONPCB |
|
Return Value
The last newly created DlxText object. Call the IsValid() method to determine if the
object was created correctly.
Example
|
|
Copy code
|
var prj = DlxApp.GetJob().GetProject("Example Sch");
if (!prj.IsValid())
prj = DlxApp.GetJob().NewProject("Example Sch");
var doc = prj.GetDocument("Examples Sch", DlxApp.DOCTYPE_SCHEMATIC);
if (!doc.IsValid())
{
doc = prj.NewDocument("Examples Sch", DlxApp.DOCTYPE_SCHEMATIC);
doc.SetPageFormat("A4", false);
}
if (doc.IsValid() && doc.Activate())
{
var page = doc.GetActivePage();
if (page.IsValid())
{
var layer = page.GetLayerFromType(DlxApp.LAYERTYPE_DRAWING);
if (layer.IsValid())
{
layer.DrawText(new DlxPoint(90,100), "Hello, World.");
}
}
}
|
See also