ProvideToolWindowAttribute Classe

Definizione

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à
ProvideToolWindowAttribute
Attributi

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.

Si applica a