ProvideToolWindowAttribute Klasa

Definicja

Przestrzeń nazw:

Microsoft.VisualStudio.Shell

Zestaw:

Microsoft.VisualStudio.Shell.15.0.dll

Pakiet:

Microsoft.VisualStudio.Shell.15.0 v17.12.40392

Powiadamia program Visual Studio, że pakiet VSPackage jest właścicielem okna narzędzi.

public ref class ProvideToolWindowAttribute sealed : Microsoft::VisualStudio::Shell::RegistrationAttribute

public ref class ProvideToolWindowAttribute sealed : Microsoft::VisualStudio::Shell::RegistrationAttribute

[System.AttributeUsage(System.AttributeTargets.Class, AllowMultiple=true, Inherited=true)]
public sealed class ProvideToolWindowAttribute : Microsoft.VisualStudio.Shell.RegistrationAttribute

[<System.AttributeUsage(System.AttributeTargets.Class, AllowMultiple=true, Inherited=true)>]
type ProvideToolWindowAttribute = class
    inherit RegistrationAttribute

Public NotInheritable Class ProvideToolWindowAttribute
Inherits RegistrationAttribute

Dziedziczenie

Attribute

RegistrationAttribute

ProvideToolWindowAttribute

Atrybuty

AttributeUsageAttribute

Uwagi

Kiedy zadzwonić

Zaimplementuj klasę ProvideToolWindowAttribute , gdy pakiet VSPackage implementuje co najmniej jedno okno narzędzi.

Podstawowe użycie

Ten atrybut deklaruje, że określony pakiet VSPackage jest właścicielem okna narzędzi. Pomaga również określić pozycjonowanie i trwałość okna narzędzi podczas jego tworzenia. Aby użyć metody ProvideToolWindowAttribute, umieść ją w klasie pakietu pochodzącej z Package klasy lub implementacji IVsPackage.

Ten atrybut jest używany tylko do udostępniania danych dla zewnętrznych narzędzi rejestracji. Nie ma żadnego wpływu na zachowanie środowiska uruchomieniowego pakietu VSPackage.

Wpisy rejestru

• Klasa ProvideToolWindowAttribute tworzy następujące wpisy rejestru:

• <VSROOT>\ToolWindows\{ToolWindowGuid}

• <VSROOT>\ToolWindows\{ToolWindowGuid}\@={ToolWindowTypeGuid}

• <VSROOT>\ToolWindows\{ToolWindowGuid}\Name=ToolWindowName

• Następujące wpisy rejestru są opcjonalne:

• <VSROOT>\ToolWindows\{ToolWindowGuid}\Float=FloatPosition

• <VSROOT>\ToolWindows\{ToolWindowGuid}\Style=ToolWindowStyle

• <VSROOT>\ToolWindows\{ToolWindowGuid}\Window=DockWith

• <VSROOT>\ToolWindows\{ToolWindowGuid}\Orientation=ToolWindowOrientation

Konstruktory

ProvideToolWindowAttribute(Type)

Inicjuje nowe wystąpienie klasy ProvideToolWindowAttribute.

Właściwości

AutoHidden	Ustaw wartość true, aby domyślnie ukryć okno narzędzia.
DockedHeight	Pobiera ore ustawia domyślną wysokość ToolWindow po zadokowaniu.
DockedWidth	Pobiera ore ustawia domyślną szerokość ToolWindow po zadokowaniu.
DocumentLikeTool	Ustaw tę właściwość na wartość true, jeśli chcesz, aby okno narzędzia było podobne do dokumentu w jego zachowaniu i okresie istnienia. Okno narzędzia będzie tylko mdI lub zmiennoprzecinkowe i pozostanie widoczne w jego pozycji we wszystkich zmianach układu do momentu ręcznego zamknięcia przez użytkownika, w którym momencie zostanie zniszczony. Ta flaga oznacza DontForceCreate i destrukcyjne wiele wystąpień.
Height	Pobiera lub ustawia domyślną wysokość okna narzędzi.
MultiInstances	Określa, czy dozwolone jest wiele wystąpień okna narzędzi.
Orientation	Pobiera lub ustawia domyślną orientację okna narzędzi względem okna określonego przez właściwość Window.
PositionX	Pobiera lub ustawia domyślną wartość poziomą lewego górnego rogu okna narzędzia.
PositionY	Pobiera lub ustawia wartość pionową lewego górnego rogu okna narzędzia.
Style	Pobiera lub ustawia domyślny styl dokowania dla okna narzędzi.
ToolType	Pobiera lub ustawia typ okna narzędzia.
Transient	Pobiera lub ustawia, czy okno narzędzia nie powinno być ponownie otwierane po ponownym uruchomieniu środowiska IDE.
TypeId	Zastąp właściwość TypeID, aby umożliwić klasom pochodnym RegistrationAttribute pracować z atrybutem System.ComponentModel.TypeDescriptor.GetAttributes(...). Atrybut pochodzący z tego atrybutu będzie musiał zastąpić tę właściwość tylko wtedy, gdy potrzebuje lepszej kontroli nad wystąpieniami, które można zastosować do klasy. (Odziedziczone po RegistrationAttribute)
Width	Pobiera lub ustawia domyślną szerokość okna narzędzi.
Window	Pobiera lub ustawia identyfikator GUID domyślnego okna, w którym powinno być zadokowane okno narzędzia.

Metody

GetPackageRegKeyPath(Guid)	Pobiera ścieżkę rejestru (względem katalogu głównego rejestru aplikacji) pakietu VSPackage. (Odziedziczone po RegistrationAttribute)
Register(RegistrationAttribute+RegistrationContext)	Rejestruje okno narzędzia.
Unregister(RegistrationAttribute+RegistrationContext)	Usuwa klucz rejestru dla okna narzędzi.