ToolWindow – třída

Článek
05/14/2013

Odvozené třídy přepsány, představuje nástroj okna v Návrháři generované pro domény specifické pro jazyk.

Toto rozhraní API není kompatibilní se specifikací CLS.

Hierarchie dědičnosti

System.Object
  Microsoft.VisualStudio.Shell.WindowPane
    Microsoft.VisualStudio.Modeling.Shell.ModelingWindowPane
      Microsoft.VisualStudio.Modeling.Shell.ToolWindow
        Microsoft.VisualStudio.Modeling.Shell.ModelExplorerToolWindow

Obor názvů: Microsoft.VisualStudio.Modeling.Shell
Sestavení: Microsoft.VisualStudio.Modeling.Sdk.Shell.11.0 (v Microsoft.VisualStudio.Modeling.Sdk.Shell.11.0.dll)

Syntaxe

'Deklarace
<CLSCompliantAttribute(False)> _
Public MustInherit Class ToolWindow _
    Inherits ModelingWindowPane

[CLSCompliantAttribute(false)]
public abstract class ToolWindow : ModelingWindowPane

Typ ToolWindow zveřejňuje následující členy.

Konstruktory

	Název	Popis
	ToolWindow	Vytvoří novou instanci třídy ToolWindow.

Nahoru

Vlastnosti

	Název	Popis
	ActiveInPlaceEditWindow	Získá a nastaví aktivní okno pro úpravy na místě. (Zděděno z ModelingWindowPane.)
	BitmapIndex	V odvozené třídě vyzkoušený při načte index bitmapy, objeví se vedle názvu okna nástroje.
	BitmapResource	Při vyzkoušený v odvozené třídě získá číslo ID zdroje bitmapy, objeví se vedle názvu okna nástroje.
	Content	(Zděděno z WindowPane.)
	DocData	Získá dokumentu v paměti.
	EnableUndo	Získá okno nástroje a umožňuje zpět příkaz.
	Frame	Získává IVsWindowFrame odpovídá toto okno.. (Zděděno z ModelingWindowPane.)
	HasSelectableObjects	Okno nástroje zakáže získá Vybrat objekty příkaz, pokud dokument není načten. (Přepisuje ModelingWindowPane.HasSelectableObjects.)
	HasToolBar	V okně Nástroj získá a ověří, zda by měla mít panel nástrojů.
	HelpService	Získá nápovědu služby. (Zděděno z ModelingWindowPane.)
	InitializationMode	(Zděděno z WindowPane.)
	MenuService	Získá služba příkazů nabídky. (Zděděno z ModelingWindowPane.)
	PrimarySelection	V podokně okna získá primární vybraný prvek. (Zděděno z ModelingWindowPane.)
	SelectedElements	Získá prvky, které jsou vybrány v podokně okna. (Zděděno z ModelingWindowPane.)
	SelectionCount	Počet prvků, které jsou vybrány v podokně okna získá. (Zděděno z ModelingWindowPane.)
	SelectionHelpService	Získá nápovědu služby výběru. (Zděděno z ModelingWindowPane.)
	ServiceProvider	Poskytovatel metadat, který je v tomto podokně okna místní získá. (Zděděno z ModelingWindowPane.)
	ToolBarHost	Získává IVsToolWindowToolbarHost rozhraní, které určuje vzhled panelů nástrojů v okně nástroje.
	ToolWindowFont	Získá písma pro okno nástroje.
	Window	(Zděděno z WindowPane.)
	WindowTitle	Získá název okna nástroje.

Nahoru

Metody

	Název	Popis
	CommitPendingEditForCommand	Po implementaci odvozené třídy určuje, zda čekající úpravy by měla být potvrzena před provedením příkazu. (Zděděno z ModelingWindowPane.)
	CountAllObjects	Získá počet prvků v podokně okna. (Zděděno z ModelingWindowPane.)
	CountObjects	Vrátí počet prvků v podokně okna nebo v aktuálním výběru. (Zděděno z ModelingWindowPane.)
	CountSelectedObjects	Získá počet prvků v aktuálním výběru. (Zděděno z ModelingWindowPane.)
	Dispose()	(Zděděno z WindowPane.)
	Dispose(Boolean)	Uvolní nespravované prostředky používané ToolWindow a volitelně uvolní spravované prostředky. (Přepisuje ModelingWindowPane.Dispose(Boolean).)
	DoSelectObjects	Po implementaci v odvozené třídě vybere prvků v podokně okna. (Zděděno z ModelingWindowPane.)
	Equals	Určuje, zda zadaný objekt je rovno aktuální objekt. (Zděděno z Object.)
	Finalize	Umožňuje objekt při uvolnění prostředků a provádět jiné operace vyčištění, dříve, než je zažádáno systémem uvolňování paměti. (Zděděno z Object.)
	GetAllObjects	Získá všechny prvky v podokně okna. (Zděděno z ModelingWindowPane.)
	GetComponentSelected	Určuje, zda je vybrána dané součásti. (Zděděno z ModelingWindowPane.)
	GetContainerSelected	Určuje, zda je vybrána daného kontejneru. (Zděděno z ModelingWindowPane.)
	GetHashCode	Slouží jako funkci hash u určitého typu. (Zděděno z Object.)
	GetObjects	Získává aktuálně vybrané prvky nebo prvky, které lze vybrat v podokně okna. (Zděděno z ModelingWindowPane.)
	GetSelectedComponents	Získá součásti, které jsou vybrány v podokně okna. (Zděděno z ModelingWindowPane.)
	GetSelectedObjects	Získá prvky, které jsou vybrány v podokně okna. (Zděděno z ModelingWindowPane.)
	GetService	Získá služby zadaného typu.Přepsat tuto metodu vrátit příkaz služby vlastní nabídky (Zděděno z ModelingWindowPane.)
	GetSite	Získá web, který byl nastaven s SetSite. (Zděděno z ModelingWindowPane.)
	GetType	Získá Type aktuální instance. (Zděděno z Object.)
	Hide	Skryje podokno okna. (Zděděno z ModelingWindowPane.)
	Initialize	Vytvoří novou instanci třídy ToolWindow. (Přepisuje WindowPane.Initialize().)
	LoadUIState	(Zděděno z WindowPane.)
	MemberwiseClone	Vytvoří kopii aktuálního Object. (Zděděno z Object.)
	OnAfterToolWindowCreate	POST-Creation inicializace.
	OnClose	Odebere objekty podokně okna z místní nabídky výběru při zavření podokna okna. (Zděděno z ModelingWindowPane.)
	OnCreate	Vytvoří okno nástroje. (Přepisuje WindowPane.OnCreate().)
	OnDocumentWindowChanged	Odvozené třídy upozorní, pokud uživatel provede změny v okně dokumentu.
	OnSelectionChanged	Po výběru změny upozornění posluchače událostí. (Zděděno z ModelingWindowPane.)
	OnSelectionChanging	Upozornění posluchače událostí před změnami výběru. (Zděděno z ModelingWindowPane.)
	OnToolWindowCreate	Sleduje změny v rámečku v okně dokumentu
	PreProcessMessage	Zpracovává zprávy okna. (Zděděno z ModelingWindowPane.)
	SaveUIState	(Zděděno z WindowPane.)
	SelectObjects	Výběr prvků v podokně okna. (Zděděno z ModelingWindowPane.)
	SetSelectedComponents(ICollection)	Přidá do kontejneru výběr zadané součásti a upozorní prostředí Změna výběru. (Zděděno z ModelingWindowPane.)
	SetSelectedComponents(ICollection, SelectionTypes)	Není aktuálně implementováno. (Zděděno z ModelingWindowPane.)
	SetSite	Inicializuje podokně okna v prostředí. (Zděděno z ModelingWindowPane.)
	Show	Zobrazí podokno okna, přenese do popředí a je aktivní okno. (Zděděno z ModelingWindowPane.)
	ShowNoActivate	Zobrazí podokno okna přenese do popředí, ale není jej provádět aktivní okno. (Zděděno z ModelingWindowPane.)
	ToString	Vrátí řetězec, který představuje aktuální objekt. (Zděděno z Object.)

Nahoru

Události

	Název	Popis
	SelectionChanged	Je aktivována po změně výběru v podokně okna. (Zděděno z ModelingWindowPane.)
	SelectionChanging	Je aktivována před výběr v podokně okna změní. (Zděděno z ModelingWindowPane.)

Nahoru

Explicitní implementace rozhraní

	Název	Popis
	IVsWindowPane.ClosePane	Zastaralé. (Zděděno z WindowPane.)
	IVsUIElementPane.CloseUIElementPane	(Zděděno z WindowPane.)
	IVsWindowPane.CreatePaneWindow	Zastaralé. (Zděděno z WindowPane.)
	IVsUIElementPane.CreateUIElementPane	(Zděděno z WindowPane.)
	IOleCommandTarget.Exec	(Zděděno z WindowPane.)
	IVsWindowPane.GetDefaultSize	Zastaralé. (Zděděno z WindowPane.)
	IVsUIElementPane.GetDefaultUIElementSize	(Zděděno z WindowPane.)
	IServiceProvider.GetService	(Zděděno z WindowPane.)
	IVsUIElementPane.LoadUIElementState	(Zděděno z WindowPane.)
	IVsWindowPane.LoadViewState	Zastaralé. (Zděděno z WindowPane.)
	IOleCommandTarget.QueryStatus	(Zděděno z WindowPane.)
	IVsUIElementPane.SaveUIElementState	(Zděděno z WindowPane.)
	IVsWindowPane.SaveViewState	Zastaralé. (Zděděno z WindowPane.)
	IVsWindowPane.SetSite	Zastaralé. (Zděděno z WindowPane.)
	IVsUIElementPane.SetUIElementSite	(Zděděno z WindowPane.)
	IVsWindowPane.TranslateAccelerator	Zastaralé. (Zděděno z WindowPane.)
	IVsUIElementPane.TranslateUIElementAccelerator	(Zděděno z WindowPane.)

Nahoru

Poznámky

Než přidáte-li okno nástroj Návrhář generované, zaregistrujte okna.Další informace naleznete v tématu [Microsoft.VisualStudio.Modeling.Shell.ModelingPackage].

Příklady

Následující příklad přidá nástroj okno nazvané Vlastní okno nástroje k projektu jazyka specifické pro doménu s názvem RegisterTools.Při otevření projektu v generovaných Návrhář kartu pro toto okno zobrazí vedle Aplikaci Solution Explorer.Klepnete-li na této kartě, popisek, přečte je okno Vlastní nástroj se zobrazí v okně nástroje.

Tento kód zaregistruje okno nástroje:

using VSShellInterop = Microsoft.VisualStudio.Shell.Interop;
using VSShell = Microsoft.VisualStudio.Shell;
using DslShell = Microsoft.VisualStudio.Modeling.Shell;
using DslDesign = Microsoft.VisualStudio.Modeling.Design;
using VSTextTemplatingHost = Microsoft.VisualStudio.TextTemplating.VSHost;

namespace MS.RegisterTools.DslPackage
{
    [VSShell::ProvideToolWindowVisibility(typeof(CustomToolWindow), 
              Constants.RegisterToolsEditorFactoryId)]
    [VSShell::ProvideToolWindow(typeof(CustomToolWindow), 
              MultiInstances = false, 
              Style = VSShell::VsDockStyle.Tabbed, 
              Orientation = VSShell::ToolWindowOrientation.Right, 
              Window = "{3AE79031-E1BC-11D0-8F78-00A0C9110057}")]

    internal partial class RegisterToolsPackage
    {
        //Initializes the base class for the package
        protected override void Initialize()
        {
            base.Initialize();

            //Registers the custom tool window
            this.AddToolWindow(typeof(CustomToolWindow));
        }
    }
}

Tento kód definuje okno nástroje:

using System;
using System.Windows.Forms;
using VSShellInterop = Microsoft.VisualStudio.Shell.Interop;
using VSShell = Microsoft.VisualStudio.Shell;
using DslShell = Microsoft.VisualStudio.Modeling.Shell;
using DslDesign = Microsoft.VisualStudio.Modeling.Design;
using VSTextTemplatingHost = Microsoft.VisualStudio.TextTemplating.VSHost;

namespace MS.RegisterTools.DslPackage
{

    //Creates a tool window and gives it a title, icon, and label
    internal class CustomToolWindow : DslShell.ToolWindow
    {

        //defines a label
  private Label myLabel;
        
        //creates the tool window
  public CustomToolWindow(IServiceProvider serviceProvider) : base(serviceProvider)
  { 
  }

        //gets the icon for the tool window
        protected override int BitmapResource
        {
            get { return 104; }
        }

        //gets the index for the icon
        protected override int BitmapIndex
        {
            get { return 0; }
        }

        //gets the name of the tool window
        public override string WindowTitle
        {
            get { return "Custom Window"; }
        }

        //sets up a label
  protected override void OnToolWindowCreate()
  {
      this.myLabel = new Label();
this.myLabel.TextAlign = System.Drawing.ContentAlignment.MiddleCenter;
this.myLabel.Text = "This is the custom tool window";
   }

        //puts a label on the tool window
  public override System.Windows.Forms.IWin32Window Window
  {
       get { return this.myLabel; }
  }
    }
}

Bezpečný přístup z více vláken

Všechny veřejné členy static (Shared v jazyce Visual Basic) tohoto typu jsou bezpečné pro přístup z více vláken. Není zaručeno, že členy instancí jsou bezpečné pro přístup z více vláken.

Viz také

Referenční dokumentace

Microsoft.VisualStudio.Modeling.Shell – obor názvů

Sdílet prostřednictvím

ToolWindow – třída

Hierarchie dědičnosti

Syntaxe

Konstruktory

Vlastnosti

Metody

Události

Explicitní implementace rozhraní

Poznámky

Příklady

Bezpečný přístup z více vláken

Viz také

Referenční dokumentace

Další materiály