Methode · DrawingDoc
CreateRelativeView-Methode (DrawingDoc)
Fügt eine relative Ansicht eines Modells ein, deren Ausrichtung zwei vorher ausgewählte Elemente des Modells festlegen.
Syntax
Function CreateRelativeView( _
ByVal ModelName As String, _
ByVal XPos As Double, _
ByVal YPos As Double, _
ByVal ViewDirFront As Long, _
ByVal ViewDirRight As Long _
) As ViewSet swView = swDraw.CreateRelativeView("C:\Daten\Welle.sldprt", 0.2, 0.15, swRelativeViewCreationDirection_FRONT, swRelativeViewCreationDirection_RIGHT)Parameter
ModelNameStringByVal- Pfad und Dateiname des Modells, von dem die Ansicht entstehen soll.
XPosDoubleByVal- X-Koordinate, an der die Ansicht entsteht. Die Hilfe nennt keine Einheit. Vermutlich sind es wie bei den anderen Ansichtsbefehlen Blattkoordinaten in Metern, Ursprung ist die linke untere Ecke des Blatts.
YPosDoubleByVal- Y-Koordinate, an der die Ansicht entsteht. Für die Einheit gilt dasselbe wie bei
XPos. ViewDirFrontLongByValRichtung für die erste Orientierung als
swRelativeViewCreationDirection_e. Dem Namen und der Reihenfolge nach gehört sie zum Element mit Auswahlmarkierung 1 und sagt, als welche Seite es in der Ansicht erscheint, meist vorne. Werte:swRelativeViewCreationDirection_FRONT(0): vorneswRelativeViewCreationDirection_RIGHT(1): rechtsswRelativeViewCreationDirection_TOP(2): obenswRelativeViewCreationDirection_BACK(3): hintenswRelativeViewCreationDirection_LEFT(4): linksswRelativeViewCreationDirection_BOTTOM(5): untenswRelativeViewCreationDirection_AUXILIARY(6): von der Hilfe nicht erklärt
ViewDirRightLongByVal- Richtung für die zweite Orientierung, gleiche Werte. Dem Namen nach gehört sie zum Element mit Auswahlmarkierung 2, meist rechts.
Rückgabewert
Die neue Zeichenansicht (View). Was bei einem Fehler zurückkommt, sagt die Hilfe nicht. Prüf das Ergebnis vorsichtshalber mit Is Nothing.
Beispiel
' swApp ist SOLIDWORKS (SldWorks). Das Teil Welle.sldprt und die Zeichnung Welle.slddrw sind geöffnet.
Dim swModel As SldWorks.ModelDoc2
Dim swDraw As SldWorks.DrawingDoc
Dim swView As SldWorks.View
Dim lFehler As Long
Dim bErfolg As Boolean
' Im Teil zwei ebene Flächen auswählen (Punkte in Modellkoordinaten, Meter, an dein Teil anpassen)
Set swModel = swApp.ActivateDoc3("Welle.sldprt", False, swDontRebuildActiveDoc, lFehler)
swModel.ClearSelection2 True
bErfolg = swModel.Extension.SelectByID2("", "FACE", 0.05, 0.01, 0, False, 1, Nothing, swSelectOptionDefault)
bErfolg = swModel.Extension.SelectByID2("", "FACE", 0.1, 0, 0.02, True, 2, Nothing, swSelectOptionDefault)
' Zurück zur Zeichnung, Ansicht bei 200 mm / 150 mm einfügen
Set swDraw = swApp.ActivateDoc3("Welle.slddrw", False, swDontRebuildActiveDoc, lFehler)
Set swView = swDraw.CreateRelativeView("C:\Daten\Welle.sldprt", 0.2, 0.15, _
swRelativeViewCreationDirection_FRONT, swRelativeViewCreationDirection_RIGHT)
If swView Is Nothing Then
Debug.Print "Keine Ansicht erzeugt."
Else
Debug.Print "Neue Ansicht: " & swView.GetName2
End IfBemerkungen
Vor dem Aufruf wählst du aus:
- das Element für die erste Orientierung mit Auswahlmarkierung 1,
- das Element für die zweite Orientierung mit Auswahlmarkierung 2,
- nur bei Mehrkörperteilen: die Körper, die in der Ansicht erscheinen sollen, mit Auswahlmarkierung 4.
Die Markierung ist der Parameter Mark von ModelDocExtension.SelectByID2. Die Elemente gehören zum Modell, deshalb aktivierst du zum Auswählen das Modelldokument und danach wieder die Zeichnung, wie im Beispiel. Welche Elemente als Orientierung erlaubt sind, beschreibt die Hilfe nicht. Vermutlich sind es wie in der Oberfläche ebene Flächen oder Ebenen.
Andere Ansichten fügst du zum Beispiel mit DrawingDoc.CreateDrawViewFromModelView3, DrawingDoc.CreateSectionViewAt5, DrawingDoc.CreateAuxiliaryViewAt2 oder DrawingDoc.CreateDetailViewAt4 ein.
Siehe auch
Verfügbarkeit
SOLIDWORKS 2007
Englisches Original: IDrawingDoc::CreateRelativeView in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.