Метод Selection. Select (Visio)Selection.Select method (Visio)

Позволяет выбрать или очистить выделенный объект.Selects or clears the selection of an object.

СинтаксисSyntax

Expression. Выберите пункт (Шитобжект, селектактион)expression.Select (SheetObject, SelectAction)

Expression (выражение ) Переменная, представляющая объект Selection .expression A variable that represents a Selection object.

ПараметрыParameters

ИмяName Обязательный или необязательныйRequired/Optional Тип данныхData type ОписаниеDescription
ШитобжектSheetObject ОбязательныйRequired [ИВШАПЕ][IVSHAPE] Выражение, возвращающее объект фигуры для выбора или очистки.An expression that returns a Shape object to select or clear.
СелектактионSelectAction ОбязательныйRequired IntegerInteger Тип выполняемого действия выделения.The type of selection action to take.

Возвращаемое значениеReturn value

ОтсутствуетNothing

ПримечанияRemarks

При использовании с объектом Window метод SELECT повлияет на выбор в окне Microsoft Visio.When used with the Window object, the Select method will affect the selection in the Microsoft Visio window. Однако объект Selection не зависит от выделенного фрагмента в окне.The Selection object, however, is independent of the selection in the window. Таким образом, использование метода SELECT с объектом Selection влияет только на состояние объекта в памяти; окно Visio не изменяется.Therefore, using the Select method with a Selection object only affects the state of the object in memory; the Visio window is unaffected.

Следующие константы, объявленные библиотекой типов Visio в висселектаргс , демонстрируют допустимые значения для типов Selection.The following constants declared by the Visio type library in VisSelectArgs show valid values for selection types.

КонстантаConstant ЗначениеValue ОписаниеDescription
ВисдеселектvisDeselect 1,11 Отменяет выделение фигуры, но оставляет оставшуюся часть выделенного фрагмента без изменений.Cancels the selection of a shape but leaves the rest of the selection unchanged.
ВисселектvisSelect 22 Выбирает фигуру, но оставляет остальные элементы без изменений.Selects a shape but leaves the rest of the selection unchanged.
ВиссубселектvisSubSelect 43 Выбирает фигуру, родитель которой уже выбран.Selects a shape whose parent is already selected.
ВисселекталлvisSelectAll SP44 Выбирает фигуру и все ее дочерние узлы.Selects a shape and all its peers.
ВисдеселекталлvisDeselectAll 256256 Отменяет выбор фигуры и всех ее одноранговых узлов.Cancels the selection of a shape and all its peers.

Если селектактион имеет значение виссубселект, родительская фигура шитобжект должна быть уже выбрана.If SelectAction is visSubSelect, the parent shape of SheetObject must already be selected.

Вы можете объединить висдеселекталл с висселект и виссубселект , чтобы отменить выделение всех фигур перед выделением или выделением других фигур.You can combine visDeselectAll with visSelect and visSubSelect to cancel the selection of all shapes prior to selecting or subselecting other shapes.

Если обрабатываемый объект является объектом Selection , и если метод SELECT выбирает объект Shape , свойство контаинингшапе которого отличается от свойства контаинингшапе выделенного фрагмента , метод SELECT очищает все, даже если значение типа Selection не указывает на отмену выделения.If the object being operated on is a Selection object, and if the Select method selects a Shape object whose ContainingShape property is different from the ContainingShape property of the Selection object, the Select method clears everything, even if the selection type value does not specify canceling the selection.

Если обрабатываемый объект является объектом Window , а если селектактион не Виссубселект, родительской формой шитобжект должна быть та же форма, что и в свойстве контаинингшапе элемента ** Объект Window. Selection** .If the object being operated on is a Window object, and if SelectAction is not visSubSelect, the parent shape of SheetObject must be the same shape as that returned by the ContainingShape property of the Window.Selection object.

ПримерExample

В этом макросе Microsoft Visual Basic для приложений (VBA) показано, как выбирать, очищать и подвыбирать фигуры.This Microsoft Visual Basic for Applications (VBA) macro shows how to select, clear, and subselect shapes.

 
Public Sub Select_Example() 
 
 Const MAX_SHAPES = 6 
 Dim vsoShapes(1 To MAX_SHAPES) As Visio.Shape 
 Dim intCounter As Integer 
 
 'Draw six rectangles. 
 For intCounter = 1 To MAX_SHAPES 
 Set vsoShapes(intCounter) = ActivePage.DrawRectangle(intCounter, intCounter + 1, intCounter + 1, intCounter) 
 Next intCounter 
 
 'Cancel the selection of all the shapes on the page. 
 ActiveWindow.DeselectAll 
 
 'Create a Selection object. 
 Dim vsoSelection As Visio.Selection 
 Set vsoSelection = ActiveWindow.Selection 
 
 'Select the first three shapes on the page. 
 For intCounter = 1 To 3 
 vsoSelection.Select vsoShapes(intCounter), visSelect 
 Next intCounter 
 
 'Group the selected shapes. 
 'Although the first three shapes are now grouped, the 
 'array vsoShapes() still contains them. 
 Dim vsoGroup As Visio.Shape 
 Set vsoGroup = vsoSelection.Group 
 
 'There are now four shapes on the page - a group that contains three 
 'subshapes, and three ungrouped shapes. Subselection is 
 'accomplished by selecting the parent shape first or one of the 
 'group's shapes already subselected. 
 
 'Select parent (group) shape. 
 ActiveWindow.Select vsoGroup, visDeselectAll + visSelect 
 
 'Subselect two of the shapes in the group. 
 ActiveWindow.Select vsoShapes(1), visSubSelect 
 ActiveWindow.Select vsoShapes(3), visSubSelect 
 
 'At this point two shapes are subselected, but we want to 
 'start a new selection that includes the last two shapes 
 'added to the page and the group. 
 
 'Note that the subselections that were made in the group 
 'are canceled by selecting another shape that is 
 'at the same level as the parent of the subselected shapes. 
 
 'Select just one shape. 
 ActiveWindow.Select vsoShapes(MAX_SHAPES), _ 
 visDeselectAll + visSelect 
 
 'Select another shape. 
 ActiveWindow.Select vsoShapes(MAX_SHAPES - 1), visSelect 
 
 'Select the group. 
 ActiveWindow.Select vsoGroup, visSelect 
 
 'Select all but one shape on the page. 
 ActiveWindow.SelectAll 
 ActiveWindow.Select vsoShapes(MAX_SHAPES - 1), visDeselect 
 
End Sub

Поддержка и обратная связьSupport and feedback

Есть вопросы или отзывы, касающиеся Office VBA или этой статьи?Have questions or feedback about Office VBA or this documentation? Руководство по другим способам получения поддержки и отправки отзывов см. в статье Поддержка Office VBA и обратная связь.Please see Office VBA support and feedback for guidance about the ways you can receive support and provide feedback.