ProvideToolWindowAttribute 類別

定義

命名空間:

Microsoft.VisualStudio.Shell

組件:

Microsoft.VisualStudio.Shell.15.0.dll

套件:

Microsoft.VisualStudio.Shell.15.0 v17.12.40392

通知 Visual Studio VSPackage 擁有工具視窗。

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

繼承

Attribute

RegistrationAttribute

ProvideToolWindowAttribute

屬性

AttributeUsageAttribute

備註

呼叫時機

當 VSPackage 實作一或多個工具視窗時， ProvideToolWindowAttribute 實作 類別。

基本使用方式

這個屬性會宣告特定 VSPackage 擁有工具視窗。 它也有助於判斷工具視窗在建立時的位置和持續性。 若要使用 ProvideToolWindowAttribute，請將它放在衍生自 Package 或 實作 的 IVsPackage封裝類別上。

此屬性僅用於提供外部註冊工具的數據。 它不會影響 VSPackage 的運行時間行為。

登錄項目

• 類別 ProvideToolWindowAttribute 會建立下列登錄專案：

• <VSROOT>\ToolWindows\{ToolWindowGuid}

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

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

• 下列登入項目是選擇性專案：

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

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

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

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

建構函式

ProvideToolWindowAttribute(Type)

初始化 ProvideToolWindowAttribute 的新執行個體。

屬性

AutoHidden	設定為 true，預設會隱藏工具視窗。
DockedHeight	取得 ore 會在停駐時設定 ToolWindow 的預設高度。
DockedWidth	取得 ore 會在停駐時設定 ToolWindow 的預設寬度。
DocumentLikeTool	如果您要工具視窗的行為和存留期中的檔，請將此屬性設定為 true。 工具視窗只會是 MDI 或浮動，而且在所有版面配置變更的位置上保持可見，直到使用者手動關閉時才會終結。 此旗標表示 DontForceCreate 和破壞性多重實例。
Height	取得或設定工具視窗的預設高度。
MultiInstances	判斷是否允許工具視窗的多個實例。
Orientation	取得或設定工具視窗相對於 Window 屬性所指定的視窗的預設方向。
PositionX	取得或設定工具視窗左上角的預設水準值。
PositionY	取得或設定工具視窗左上角的垂直值。
Style	取得或設定工具視窗的預設停駐樣式。
ToolType	取得或設定工具視窗的類型。
Transient	取得或設定 IDE 重新啟動時，是否不應該重新開啟工具視窗。
TypeId	覆寫 TypeID 屬性，讓 RegistrationAttribute 衍生類別使用 System.ComponentModel.TypeDescriptor.GetAttributes (...) 。衍生自這個屬性的屬性必須覆寫此屬性，只有在實例上需要更好的控件，才能套用至類別。 (繼承來源 RegistrationAttribute)
Width	取得或設定工具視窗的預設寬度。
Window	取得或設定應該停駐工具視窗的預設視窗 GUID。

方法

GetPackageRegKeyPath(Guid)	取得相對於 VSPackage 應用程式) 之登錄根目錄的登錄路徑 (。 (繼承來源 RegistrationAttribute)
Register(RegistrationAttribute+RegistrationContext)	註冊工具視窗。
Unregister(RegistrationAttribute+RegistrationContext)	拿掉工具視窗的登錄機碼。