ProvideToolWindowAttribute Classe

Definizione

Spazio dei nomi:

Microsoft.VisualStudio.Shell

Assembly:

Microsoft.VisualStudio.Shell.15.0.dll

Pacchetto:

Microsoft.VisualStudio.Shell.15.0 v17.12.40392

Notifica a Visual Studio che un VSPackage è proprietario di una finestra degli strumenti.

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

Ereditarietà

Attribute

RegistrationAttribute

ProvideToolWindowAttribute

Attributi

AttributeUsageAttribute

Commenti

Quando chiamare

Implementare la ProvideToolWindowAttribute classe quando un VSPackage implementa una o più finestre degli strumenti.

Utilizzo di base

Questo attributo dichiara che un VSPackage specifico è proprietario di una finestra degli strumenti. Consente inoltre di determinare il posizionamento e la persistenza della finestra degli strumenti al momento della creazione. Per usare ProvideToolWindowAttribute, inserirlo in una classe di pacchetto derivata da Package o implementando IVsPackage.

Questo attributo viene usato solo per fornire dati per gli strumenti di registrazione esterni. Non ha alcun effetto sul comportamento di runtime del VSPackage.

Voci del Registro di sistema

• La ProvideToolWindowAttribute classe crea le voci del Registro di sistema seguenti:

• <VSROOT>\ToolWindows\{ToolWindowGuid}

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

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

• Le voci del Registro di sistema seguenti sono facoltative:

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

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

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

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

Costruttori

ProvideToolWindowAttribute(Type)

Inizializza una nuova istanza di ProvideToolWindowAttribute.

Proprietà

AutoHidden	Impostare su true per nascondere la finestra degli strumenti per impostazione predefinita.
DockedHeight	Ottiene ore imposta l'altezza predefinita di ToolWindow quando è ancorata.
DockedWidth	Ottiene l'ore imposta la larghezza predefinita di ToolWindow quando è ancorata.
DocumentLikeTool	Impostare questa proprietà su true se si desidera una finestra degli strumenti simile a un documento nel comportamento e nella durata. La finestra degli strumenti sarà solo MDI o mobile e rimarrà visibile nella sua posizione in tutte le modifiche di layout fino a quando l'utente non verrà chiuso manualmente a quel punto verrà eliminato definitivamente. Questo flag implica DontForceCreate e un'istanza multipla distruttiva.
Height	Ottiene o imposta l'altezza predefinita della finestra degli strumenti.
MultiInstances	Determina se più istanze della finestra degli strumenti sono consentite.
Orientation	Ottiene o imposta l'orientamento predefinito per la finestra degli strumenti relativa alla finestra specificata dalla proprietà Window.
PositionX	Ottiene o imposta il valore orizzontale predefinito dell'angolo superiore sinistro della finestra degli strumenti.
PositionY	Ottiene o imposta il valore verticale dell'angolo superiore sinistro della finestra degli strumenti.
Style	Ottiene o imposta lo stile di ancoraggio predefinito per la finestra degli strumenti.
ToolType	Ottiene o imposta il tipo della finestra degli strumenti.
Transient	Ottiene o imposta un valore che indica se la finestra degli strumenti non deve essere riaperta quando l'IDE viene riavviato.
TypeId	Eseguire l'override della proprietà TypeID per consentire alle classi derivate RegistrationAttribute di usare System.ComponentModel.TypeDescriptor.GetAttributes(...). Un attributo derivato da questo deve eseguire l'override di questa proprietà solo se necessita di un controllo migliore sulle istanze che possono essere applicate a una classe. (Ereditato da RegistrationAttribute)
Width	Ottiene o imposta la larghezza predefinita della finestra degli strumenti.
Window	Ottiene o imposta il GUID della finestra predefinita in cui la finestra degli strumenti deve essere ancorata.

Metodi

GetPackageRegKeyPath(Guid)	Ottiene il percorso del Registro di sistema (relativo alla radice del Registro di sistema dell'applicazione) del pacchetto VS. (Ereditato da RegistrationAttribute)
Register(RegistrationAttribute+RegistrationContext)	Registra la finestra degli strumenti.
Unregister(RegistrationAttribute+RegistrationContext)	Rimuove la chiave del Registro di sistema per la finestra degli strumenti.