Метод Document.Clean (Visio)
Проверяет, сообщает и исправит выбранные условия в документе.
Синтаксис
expression. Clean (nTargets, nActions, nAlerts, nFixes, bStopOnError, bLogFileName, nReserved)
Выражение Переменная, представляющая объект Document .
Параметры
| Имя | Обязательный или необязательный | Тип данных | Описание |
|---|---|---|---|
| nTargets | Необязательный | Variant | Указывает, какие части документа следует изучить. Возможные значения см. в разделе Примечания. |
| nActions | Необязательный | Variant | Указывает, какие условия следует обнаружить. Возможные значения см. в разделе Примечания. |
| nAlerts | Необязательный | Variant | Указывает, какие обнаруженные условия необходимо сообщить. Возможные значения см. в разделе Примечания. |
| nFixes | Необязательный | Variant | Указывает, какие обнаруженные условия следует исправить. Возможные значения см. в разделе Примечания. |
| bStopOnError | Необязательный | Variant | Ненулевое значение (True) для остановки обработки при обнаружении ошибки при попытке исправить обнаруженное условие; ноль (false), чтобы разрешить продолжение обработки. |
| bLogFileName | Необязательный | Variant | Зарезервировано для последующего использования. |
| nЗарезервировано | Необязательный | Variant | Зарезервировано для последующего использования. |
Возвращаемое значение
Отсутствует
Примечания
Внутренние разработчики Microsoft Visio используют метод Clean для проверки и оптимизации документов, предоставляемых Visio. Сторонние разработчики могут использовать этот метод в своих документах.
Разработчикам рекомендуется использовать значения по умолчанию для nTargets , nActions , nAlerts и nFixes и создать резервную копию документа перед его очисткой.
Вы можете определить изменения документа, внесенные методом Clean , сравнив сохраненные версии документа VDX (XML), одну версию, сохраненную до выполнения метода Clean , а другую — после.
Аргумент nTargets может быть любым сочетанием значений констант, определенных в VisDocCleanTargets в библиотеке типов Visio и описанных в следующей таблице.
| Константа | Значение | Описание |
|---|---|---|
| visDocCleanTargAll | &HFF | Проверьте все объекты (по умолчанию для nTargets ). |
| visDocCleanTargFPages | &H1 | Изучите страницы переднего плана. |
| visDocCleanTargBPages | &H2 | Изучите фоновые страницы. |
| visDocCleanTargMasters | &H4 | Изучите образцы. |
| visDocCleanTargStyles | &H8 | Изучите стили. |
| visDocCleanTargDoc | &H10 | Проверьте лист документа. |
| visDocCleanTargPageSheet | &H100 | Проверьте страницы. |
Аргументы nActions, nAlerts и nFixes могут быть любым сочетанием значений констант, определенных в VisDocCleanActions в библиотеке типов Visio и описанных в следующей таблице.
| Константа | Значение | Описание |
|---|---|---|
| visDocCleanActLocalFormulas | &H1 | Обнаружение ненужных локальных переопределений. |
| visDocCleanActEmptyRowsAndSects | &H2 | Обнаружение пустых локальных строк и разделов. |
| visDocCleanActNonDefaultFonts | &H4 | Обнаружение параметров шрифта, отличных от шрифта по умолчанию. |
| visDocCleanActStaleResults | &H8 | Обнаружение результатов, которые не соответствуют формулам. |
| visDocCleanActMissingSubs | &H10 | Обнаружение отсутствующих подписок (зависимостей ячеек). |
| visDocCleanActConstantFormulas | &H20 | Обнаружение формул, которые могут быть созданы на основе результата. |
| visDocCleanActNearZero | &H40 | Обнаруживайте почти нулевые результаты и изменяйте их на ноль. |
| visDocCleanActDuplicateSubs | &H80 | Обнаружение повторяющихся подписок (зависимостей ячеек). |
| visDocCleanActBadDisplayLists | &H100 | Обнаружение недопустимых связей списка отображения. |
| visDocCleanActDeletedFields | &H400 | Обнаружение удаленных полей. |
| visDocCleanActBadFieldFormulas | &H800 | Обнаружение полей с отсутствующими или нестандартными формулами. |
| visDocCleanActBadFieldMarks | &H1000 | Обнаружение полей с несинхронизированным числом и значениями маркеров. Измените положение escape-символов в соответствии с числом символов. |
| visDocCleanActBadReferences | &H2000 | Обнаружение формул с ошибками #Ref(). |
| visDocCleanActAll | &H3FFF | Выполнение всех действий. |
| visDocCleanActDefault | &H1FD8 | Условия по умолчанию для обнаружения (значение по умолчанию nActions ). |
| visDocCleanAlertDefault | &H0 | Условия по умолчанию для отчета (значение по умолчанию nAlerts ). |
| visDocCleanFixDefault | &H3D8 | Условия по умолчанию для исправления (значение по умолчанию для nFixes ). |
Пример
В следующей процедуре демонстрируется одно использование метода Clean . В этом случае шаблон линий прямоугольника переопределяется тем же значением, которое он унаследовал изначально, что создает ненужное локальное переопределение. Затем выполняется метод Clean , который обнаруживает условие и публикует оповещение, позволяющее пользователю выбрать, следует ли исправить условие.
Создайте пустой документ.
Используйте инструмент "Прямоугольник" , чтобы нарисовать прямоугольник на странице документа. При просмотре фигуры в окне Таблица фигур можно увидеть, что цвет значения ("1") в ячейке LinePattern черный, что указывает на то, что значение наследуется.
Щелкните фигуру правой кнопкой мыши, наведите указатель на пункт Формат, выберите пункт Линия и в диалоговом окне Линия повторно примените тот же шаблон строки. Это действие создает локальное значение в фигуре или локальное переопределение. Теперь при просмотре фигуры в окне Таблицы фигур можно увидеть, что цвет значения в ячейке LinePattern будет синим, что указывает на то, что значение является локальным.
Вставьте приведенную ниже процедуру Clean_Example в проект Microsoft Visual Basic для приложений документа:
Запустите процедуру Clean_Example (на вкладке Вид щелкните Макросы; затем в диалоговом окне Макросы в списке макросов выберите ThisDocument.Clean_Example и нажмите кнопку Выполнить).
Public Sub Clean_Example()
ActiveDocument.Clean, visDocCleanActLocalFormulas, _
visDocCleanActLocalFormulas, visDocCleanActLocalFormulas
End Sub
На странице документа отображаются оповещения о том, нужно ли удалить ненужное локальное переопределение. Если нажать кнопку Да , а затем снова открыть окно Таблица фигур, вы увидите, что цвет значения в ячейке LinePattern снова будет черным, что означает, что наследуемое значение восстановлено.
Поддержка и обратная связь
Есть вопросы или отзывы, касающиеся Office VBA или этой статьи? Руководство по другим способам получения поддержки и отправки отзывов см. в статье Поддержка Office VBA и обратная связь.