SolidWorksMakroprogrammierung

Methode · DrawingDoc

CreateText2-Methode (DrawingDoc)

Erzeugt einen Hinweis mit dem angegebenen Text an einer bestimmten Stelle der Zeichnung.

Syntax

Function CreateText2( _
   ByVal TextString As String, _
   ByVal TextX As Double, _
   ByVal TextY As Double, _
   ByVal TextZ As Double, _
   ByVal TextHeight As Double, _
   ByVal TextAngle As Double _
) As Object
Set swNote = swDraw.CreateText2("Entgratet", 0.02, 0.05, 0, 0.005, 0)

Parameter

TextStringStringByVal
Der Text des Hinweises.
TextXDoubleByVal
X-Koordinate in Metern (siehe Bemerkungen).
TextYDoubleByVal
Y-Koordinate in Metern.
TextZDoubleByVal
Z-Koordinate in Metern. Auf dem ebenen Blatt übergibst du 0.
TextHeightDoubleByVal
Schrifthöhe in Metern, etwa 0.005 für 5 mm.
TextAngleDoubleByVal
Drehwinkel des Texts im Bogenmaß, 0 für waagrechten Text. In welche Richtung positive Winkel drehen, sagt die Hilfe nicht.

Rückgabewert

Der neue Hinweis (Note). Was bei einem Fehler zurückkommt, sagt die Hilfe nicht. Prüf das Ergebnis mit Is Nothing.

Beispiel

' swDraw ist die aktive Zeichnung (DrawingDoc), etwa per Set swDraw = swModel.
Dim swNote As SldWorks.Note
Dim dPi As Double
dPi = 4 * Atn(1)
' Hinweis bei x = 15 mm, y = 120 mm, 5 mm hoch, um 90 Grad gedreht
Set swNote = swDraw.CreateText2("Nur zur Information", 0.015, 0.12, 0, 0.005, dPi / 2)
If swNote Is Nothing Then
    Debug.Print "Hinweis wurde nicht erzeugt."
Else
    Debug.Print "Neuer Hinweis: " & swNote.GetText
End If

Bemerkungen

Die Koordinaten geben die linke obere Ecke des Rahmens um den Text an, gemessen von der linken unteren Ecke der Zeichnung. Ob der Hinweis zum Blatt oder zu einer gerade aktiven Zeichenansicht gehört, sagt die Hilfe nicht.

Ersetzt DrawingDoc.CreateText, das nur True oder False lieferte. CreateText2 gibt dir dagegen den Hinweis zurück, den du danach weiter bearbeiten kannst.

Siehe auch

Verfügbarkeit

In allen aktuellen Versionen vorhanden. Seit wann es den Befehl gibt, nennt die Hilfe nicht.

Englisches Original: IDrawingDoc::CreateText2 in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)

Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.