Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Überprüft, meldet und repariert ausgewählte Bedingungen in einem Dokument.
Syntax
Ausdruck verwendet werden. Clean (nTargets, nActions, nAlerts, nFixes, bStopOnError, bLogFileName, nReserved)
Ausdruck Eine Variable, die ein Document-Objekt darstellt.
Parameter
| Name | Erforderlich/Optional | Datentyp | Beschreibung |
|---|---|---|---|
| nTargets | Optional | Variant | Gibt an, welche Teile des Dokuments überprüft werden sollen. Mögliche Werte finden Sie in den Hinweisen. |
| nActions | Optional | Variant | Gibt an, welche Bedingungen ermittelt werden sollen. Mögliche Werte finden Sie in den Hinweisen. |
| nWarnungen | Optional | Variant | Gibt an, welche erkannten Bedingungen gemeldet werden sollen. Mögliche Werte finden Sie in den Hinweisen. |
| nKorrekturen | Optional | Variant | Gibt an, welche erkannten Bedingungen repartiert werden sollen. Mögliche Werte finden Sie in den Hinweisen. |
| bStopOnError | Optional | Variant | Mit einem Wert ungleich Null (True) wird die Verarbeitung beendet, falls beim Reparieren einer erkannten Bedingung ein Fehler gefunden wird. Mit Null (False) kann die Verarbeitung fortgesetzt werden. |
| bLogFileName | Optional | Variant | Reserviert für zukünftige Verwendung. |
| nReserved | Optional | Variant | Reserviert für zukünftige Verwendung. |
Rückgabewert
Nichts
Bemerkungen
Interne Microsoft Visio-Entwickler verwenden die Clean-Methode, um die mit Visio bereitgestellten Dokumente zu überprüfen und zu optimieren. Entwickler von Drittanbietern können diese Methode für ihre eigenen Dokumente verwenden.
Es wird empfohlen, dass Entwickler Standardwerte für nTargets , nActions , nAlerts und nFixes verwenden und eine Sicherungskopie eines Dokuments erstellen, bevor es bereinigt wird.
Von der Clean-Methode vorgenommene Dokumentänderungen können Sie durch Vergleichen gespeicherter VDX (XML)-Versionen des Dokuments identifizieren, und zwar eine Version, die vor und eine Version, die nach dem Ausführen der Clean-Methode gespeichert wurde.
Das Argument nTargets kann eine beliebige Kombination der Werte der Konstanten sein, die in VisDocCleanTargets in der Visio-Typbibliothek definiert sind und in der folgenden Tabelle beschrieben werden.
| Konstante | Wert | Beschreibung |
|---|---|---|
| visDocCleanTargAll | &HFF | Untersuchen Sie alle Objekte (Standard für nTargets ). |
| visDocCleanTargFPages | &H1 | Vordergrundblätter überprüfen. |
| visDocCleanTargBPages | &H2 | Hintergrundblätter überprüfen. |
| visDocCleanTargMasters | &H4 | Master-Shape überprüfen. |
| visDocCleanTargStyles | &H8 | Formatvorlagen überprüfen. |
| visDocCleanTargDoc | &H10 | Dokumentblatt überprüfen. |
| visDocCleanTargPageSheet | &H100 | Seitenblätter überprüfen. |
Die Argumente nActions, nAlerts und nFixes können eine beliebige Kombination der Werte der Konstanten sein, die in VisDocCleanActions in der Visio-Typbibliothek definiert sind und in der folgenden Tabelle beschrieben werden.
| Konstante | Wert | Beschreibung |
|---|---|---|
| visDocCleanActLocalFormulas | &H1 | Unbenötigte lokale Überschreibungen erkennen. |
| visDocCleanActEmptyRowsAndSects | &H2 | Leere lokale Zeilen und Abschnitte erkennen. |
| visDocCleanActNonDefaultFonts | &H4 | Nicht standardmäßige Schriftarteinstellungen erkennen. |
| visDocCleanActStaleResults | &H8 | Ergebnisse erkennen, die nicht mit Formeln übereinstimmen. |
| visDocCleanActMissingSubs | &H10 | Fehlende Abonnements erkennen (Zellabhängigkeiten). |
| visDocCleanActConstantFormulas | &H20 | Formeln erkennen, die vom Ergebnis generiert werden können. |
| visDocCleanActNearZero | &H40 | Ergebnisse erkennen, die fast Null sind, und in Null ändern. |
| visDocCleanActDuplicateSubs | &H80 | Doppelte Abonnements erkennen (Zellabhängigkeiten). |
| visDocCleanActBadDisplayLists | &H100 | Ungültige Anzeigelistenverknüpfungen erkennen. |
| visDocCleanActDeletedFields | &H400 | Gelöschte Felder erkennen. |
| visDocCleanActBadFieldFormulas | &H800 | Felder mit fehlenden oder nicht standardmäßigen Formeln erkennen. |
| visDocCleanActBadFieldMarks | &H1000 | Felder mit nicht synchronisierten Werten für Anzahl und Marker. Die Position von Escapezeichen ändern, um die Anzahl der Zeichen abzugleichen. |
| visDocCleanActBadReferences | &H2000 | Formeln mit #Ref()-Fehlern erkennen. |
| visDocCleanActAll | &H3FFF | Alle Aktionen ausführen. |
| visDocCleanActDefault | &H1FD8 | Zu erkennende Standardbedingungen (Standardwert von nActions ). |
| visDocCleanAlertDefault | &H0 | Standardbedingungen für den Bericht (Standardwert von nAlerts ). |
| visDocCleanFixDefault | &H3D8 | Zu korrigierende Standardbedingungen (Standardwert für nFixes ). |
Beispiel
Das folgende Verfahren veranschaulicht eine Verwendung der Clean-Methode . In diesem Fall wird das Linienmuster eines Rechtecks mit demselben Wert überschrieben, den es ursprünglich geerbt hat, wodurch eine unnötige lokale Außerkraftsetzung entsteht. Anschließend wird die Clean-Methode ausgeführt, die die Bedingung erkennt und eine Warnung ausgibt, bei der der Benutzer auswählen kann, ob die Bedingung behoben werden soll oder nicht.
Erstellen Sie eine neue leere Zeichnung.
Verwenden Sie das Rechtecktool , um ein Rechteck auf dem Zeichenblatt zu zeichnen. Wenn Sie das Shape im Fenster "ShapeSheet" anzeigen, können Sie sehen, dass die Farbe des Werts ("1") in der Zelle "Linienmuster" schwarz ist, was darauf hinweist, dass der Wert geerbt wird.
Klicken Sie mit der rechten Maustaste auf das Shape, zeigen Sie auf Format, klicken Sie auf "Linie", und wenden Sie im Dialogfeld "Linie " dasselbe Linienmuster erneut an. Durch diese Aktion wird ein lokaler Wert im Shape oder eine lokale Außerkraftsetzung erstellt. Wenn Sie nun die Form im Fenster "ShapeSheet" anzeigen, können Sie sehen, dass die Farbe des Werts in der Zelle "Linienmuster" blau ist, was darauf hinweist, dass der Wert lokal ist.
Fügen Sie die im Folgenden aufgeführte Clean_Example-Prozedur in das Microsoft Visual Basic für Applikationen-Projekt Ihres Dokuments ein:
Führen Sie die Clean_Example-Prozedur (klicken Sie auf der Registerkarte Ansicht auf Makros. Wählen Sie dann im Dialogfeld Makros in der Makroliste die Option ThisDocument.Clean_Example aus, und klicken Sie dann auf Ausführen).
Public Sub Clean_Example()
ActiveDocument.Clean, visDocCleanActLocalFormulas, _
visDocCleanActLocalFormulas, visDocCleanActLocalFormulas
End Sub
Auf dem Zeichenblatt werden Warnungen angezeigt, in denen Sie gefragt werden, ob Sie die nicht benötigte lokale Außerkraftsetzung entfernen möchten. Wenn Sie auf Ja klicken und dann das ShapeSheet-Fenster erneut öffnen, können Sie sehen, dass die Farbe des Werts in der Zelle "Linienmuster" erneut schwarz ist, was darauf hinweist, dass der geerbte Wert wiederhergestellt wurde.
Support und Feedback
Haben Sie Fragen oder Feedback zu Office VBA oder zu dieser Dokumentation? Unter Office VBA-Support und Feedback finden Sie Hilfestellung zu den Möglichkeiten, wie Sie Support erhalten und Feedback abgeben können.