Toolbar.Protection-Eigenschaft (Visio)

Artikel
04/07/2023

Bestimmt, wie ein Toolbar-Objekt gegen die Bearbeitung durch Benutzer geschützt wird. Lese-/Schreibzugriff.

Syntax

Ausdruck. Schutz

Ausdruck Eine Variable, die ein Toolbar-Objekt darstellt.

Rückgabewert

Ganze Zahl

HinwBemerkungeneise

Hinweis

Ab Visio 2010 ersetzt die Microsoft Office Fluent-Benutzeroberfläche das vorherige System von mehrstufigen Menüs, Symbolleisten und Aufgabenbereichen. VBA-Objekte und -Member, die Sie in früheren Versionen von Visio zum Anpassen der Benutzeroberfläche verwendet haben, sind weiterhin in Visio verfügbar, funktionieren aber anders.

Der Wert der Protection-Eigenschaft kann sich aus einer oder mehreren der folgenden Konstanten zusammensetzen, die von der Visio-Typbibliothek in VisUIBarProtection deklariert werden.

Konstante	Wert	Beschreibung
visBarNoProtection	0	Kein Schutz.
visBarNoCustomize	1	Kann nicht angepasst werden.
visBarNoResize	2	Die Größe kann nicht geändert werden.
visBarNoMove	4	Kann nicht verschoben werden.
visBarNoChangeDock	16	Kann nicht an- oder abgedockt werden.
visBarNoVerticalDock	32	Kann nicht vertikal angedockt werden.
visBarNoHorizontalDock	64	Kann nicht horizontal angedockt werden.

Beispiel

Das folgende Beispiel zeigt, wie Sie mithilfe der Protection-Eigenschaft verhindern können, dass Benutzer eine benutzerdefinierte Symbolleiste andocken. In dem Beispiel wird der Toolbars-Auflistung eine benutzerdefinierte Symbolleiste hinzugefügt und anschließend eine Schaltfläche auf der Symbolleiste eingefügt. Die Symbolleiste wird in der Microsoft Visio-Benutzeroberfläche angezeigt und ist verfügbar, während das Dokument aktiv ist.

Rufen Sie nach Ausführung dieses Makros die ThisDocument.ClearCustomToolbars-Methode auf, um die integrierten Symbolleisten in Visio wiederherzustellen.

 
Sub Protection_Example() 
 
 Dim vsoUIObject As Visio.UIObject 
 Dim vsoToolbars As Visio.Toolbars 
 Dim vsoToolbar As Visio.Toolbar 
 Dim vsoToolbarItem As Visio.ToolbarItem 
 
 'Check whether there are document custom toolbars. 
 If ThisDocument.CustomToolbars Is Nothing Then 
 
 'Check whether there are application custom toolbars. 
 If Visio.Application.CustomToolbars Is Nothing Then 
 
 'Use the built-in toolbars. 
 Set vsoUIObject = Visio.Application.BuiltInToolbars(0) 
 
 Else 
 
 'Use the application custom toolbars. 
 Set vsoUIObject = Visio.Application.CustomToolbars.Clone 
 
 End If 
 
 Else 
 
 'Use the document custom toolbars. 
 Set vsoUIObject = ThisDocument.CustomToolbars 
 
 End If 
 
 'Get the Toolbars collection for the drawing window context. 
 Set vsoToolbars = vsoUIObject.ToolbarSets.ItemAtID( _ 
 Visio.visUIObjSetDrawing).Toolbars 
 
 'Add a toolbar to the collection. 
 Set vsoToolbar = vsoToolbars.Add 
 With vsoToolbar 
 
 'Set the title of the toolbar. 
 .Caption = "My New Toolbar" 
 
 'Float the toolbar at coordinates (300,200). 
 .Position = Visio.visBarFloating 
 .Left = 300 
 .Top = 200 
 
 'Disallow docking the new toolbar. 
 .Protection = Visio.visBarNoHorizontalDock _ 
 + Visio.visBarNoVerticalDock 
 
 End With 
 
 'Add an item to the toolbar. 
 Set vsoToolbarItem = vsoToolbar.ToolbarItems.Add 
 With vsoToolbarItem 
 
 'Set the new item to be a button. 
 .CntrlType = Visio.visCtrlTypeBUTTON 
 
 'Set the icon of the new button. 
 .FaceID = Visio.visIconIXCUSTOM_CARDS 
 
 'Set the CmdNum property of the new button 
 .CmdNum = 1 
 
 'Set the Width property of the new button 
 'wide enough that the toolbar name is readable. 
 .Width = 100 
 
 End With 
 
 'Tell Visio to use the new UIObject object while 
 'this document is active. 
 ThisDocument.SetCustomToolbars vsoUIObject 
 
End Sub

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.

Freigeben über