Methode · DrawingDoc
AutoDimension-Methode (DrawingDoc)
Bemaßt eine Zeichenansicht automatisch, meist die ausgewählte.
Syntax
Function AutoDimension( _
ByVal EntitiesToDimension As Long, _
ByVal HorizontalScheme As Long, _
ByVal HorizontalPlacement As Long, _
ByVal VerticalScheme As Long, _
ByVal VerticalPlacement As Long _
) As LonglStatus = swDraw.AutoDimension(swAutodimEntitiesAll, swAutodimSchemeBaseline, swAutodimHorizontalPlacementBelow, swAutodimSchemeBaseline, swAutodimVerticalPlacementLeft)Parameter
EntitiesToDimensionLongByValWas bemaßt wird, ein Wert aus
swAutodimEntities_e:swAutodimEntitiesAll(1): alle Elemente der AnsichtswAutodimEntitiesSelected(2): nur die ausgewählten Elemente, die mit der MarkierungswAutodimMarkEntities(1) ausgewählt sindswAutodimEntitiesBasedOnPreselect(0): SOLIDWORKS entscheidet. Gibt es so markierte Elemente, werden nur sie bemaßt, sonst alle.
HorizontalSchemeLongByValArt der waagrechten Bemaßung, ein Wert aus
swAutodimScheme_e:swAutodimSchemeBaseline(1): Bezugsmaße von einer gemeinsamen BasislinieswAutodimSchemeOrdinate(2): OrdinatenbemaßungswAutodimSchemeChain(3): Kettenmaße
swAutodimSchemeCenterline(4) geht in Zeichnungen nicht.HorizontalPlacementLongByVal- Wo die waagrechten Maße stehen, ein Wert aus
swAutodimHorizontalPlacement_e:swAutodimHorizontalPlacementAbove(1) über der Ansicht,swAutodimHorizontalPlacementBelow(-1) darunter. VerticalSchemeLongByVal- Art der senkrechten Bemaßung, Werte wie bei HorizontalScheme.
VerticalPlacementLongByVal- Wo die senkrechten Maße stehen, ein Wert aus
swAutodimVerticalPlacement_e:swAutodimVerticalPlacementLeft(-1) links der Ansicht,swAutodimVerticalPlacementRight(1) rechts davon.
Rückgabewert
Ein Wert aus swAutodimStatus_e. swAutodimStatusSuccess (0) heißt: Die Ansicht wurde bemaßt. Jeder andere Wert nennt den Grund für den Fehlschlag, zum Beispiel swAutodimStatusNoEntities (8), wenn du swAutodimEntitiesSelected übergibst, aber kein Element markiert hast. Die Enumeration gilt auch für das automatische Bemaßen von Skizzen, viele ihrer Werte betreffen nur Skizzen.
Beispiel
' swModel ist die aktive Zeichnung (ModelDoc2), swDraw dasselbe Dokument als DrawingDoc.
Dim lStatus As Long
swModel.ClearSelection2 True
If swModel.Extension.SelectByID2("Zeichenansicht1", "DRAWINGVIEW", 0, 0, 0, False, 0, Nothing, swSelectOptionDefault) Then
' waagrecht Kettenmaße unter der Ansicht, senkrecht Bezugsmaße links davon
lStatus = swDraw.AutoDimension(swAutodimEntitiesAll, swAutodimSchemeChain, swAutodimHorizontalPlacementBelow, swAutodimSchemeBaseline, swAutodimVerticalPlacementLeft)
Select Case lStatus
Case swAutodimStatusSuccess
Debug.Print "Ansicht bemaßt."
Case swAutodimStatusDatumNotUnique
Debug.Print "Mehr als ein Bezug ausgewählt."
Case Else
Debug.Print "Nicht bemaßt, Status " & lStatus
End Select
End IfBemerkungen
AutoDimension arbeitet mit der aktuellen Auswahl. Der Befehl braucht drei Angaben:
- Die Ansicht: Wähl die Zeichenansicht aus, eine Markierung ist nicht nötig. Ist keine Ansicht ausgewählt, versucht SOLIDWORKS sie aus den anderen ausgewählten Elementen zu bestimmen. Ist gar nichts ausgewählt, nimmt es die erste Ansicht, so wie die Oberfläche.
- Die Bezüge (Basislinien): Für die waagrechten Maße wählst du eine senkrechte Kante, eine senkrechte Skizzenlinie, einen Eckpunkt oder einen Skizzenpunkt mit der Markierung
swAutodimMarkHorizontalDatum(2) ausswAutodimMark_e. Für die senkrechten Maße entsprechend ein waagrechtes Element mitswAutodimMarkVerticalDatum(4). Ein Eckpunkt oder Skizzenpunkt mitswAutodimMarkOriginDatum(8) dient als Bezug für beide Richtungen. Die Markierung übergibst du beim Auswählen, etwa im Parameter Mark vonModelDocExtension.SelectByID2. Ohne Bezüge nimmt SOLIDWORKS die Elemente ganz links und ganz unten in der Ansicht. Gibst du nur einen Bezug an, entstehen nur die Maße für diese Richtung. - Die Elemente: über EntitiesToDimension und die mit
swAutodimMarkEntities(1) markierten Elemente. Bemaßt werden Linien, Punkte, Eckpunkte, Flächen und Skizzenelemente.
Bei swAutodimEntitiesSelected widerspricht sich die Hilfe: Die Befehlsseite sagt, nur markierte Elemente werden bemaßt, und swAutodimStatus_e kennt dafür den Fehler swAutodimStatusNoEntities. Die Seite der Enumeration sagt dagegen, ohne markierte Elemente wird alles bemaßt. Prüf deshalb den Rückgabewert.
Der Ansichtsname im Beispiel hängt von der Sprache ab, in einer englischen Zeichnung heißt die Ansicht "Drawing View1". Die Maße aus dem Modell holst du stattdessen mit DrawingDoc.InsertModelAnnotations3 in die Zeichnung.
Siehe auch
Verfügbarkeit
SOLIDWORKS 2005
Englisches Original: IDrawingDoc::AutoDimension in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.