C# Класс Microsoft.VisualStudio.Project.NestedProjectNode

Наследование: HierarchyNode, IPropertyNotifySink

Показать файл Открыть проект Примеры использования класса

Открытые методы

Метод	Описание
AddVirtualProject ( ) : void	Links a nested project as a virtual project to the solution.
Close ( ) : int	Return S_OK. Implementation of Closing a nested project is done in CloseNestedProject which is called by CloseChildren.
CloseNestedProjectNode ( ) : void	Closes a nested project and releases the nested hierarchy pointer.
GetAddFileFlags ( string files ) : VSADDFILEFLAGS[]	Sets the VSADDFILEFLAGS that will be used to call the IVsTrackProjectDocumentsEvents2 OnAddFiles
GetAutomationObject ( ) : object	Get the automation object for the NestedProjectNode
GetEditLabel ( ) : string	Called by the shell to get the node caption when the user tries to rename from the GUI
GetGuidProperty ( int propid, System.Guid &guid ) : int	Gets properties whose values are GUIDs.
GetIconHandle ( bool open ) : object	Gets the icon handle. It tries first the nested to get the icon handle. If that is not supported it will get it from the image list of the nested if that is supported. If neither of these is supported a default image will be shown.
GetMKDocument ( ) : string	Returns the moniker of the nested project.
GetProperty ( int propId ) : object	Gets properties of a given node or of the hierarchy.
GetQueryAddFileFlags ( string files ) : VSQUERYADDFILEFLAGS[]	Sets the VSQUERYADDFILEFLAGS that will be used to call the IVsTrackProjectDocumentsEvents2 OnQueryAddFiles
GetQueryRemoveFileFlags ( string files ) : VSQUERYREMOVEFILEFLAGS[]	Sets the VSQUERYREMOVEFILEFLAGS that will be used to call the IVsTrackProjectDocumentsEvents2 OnQueryRemoveFiles
GetRemoveFileFlags ( string files ) : VSREMOVEFILEFLAGS[]	Sets the VSREMOVEFILEFLAGS that will be used to call the IVsTrackProjectDocumentsEvents2 OnRemoveFiles
IgnoreItemFileChanges ( bool ignoreFlag ) : void	Flag indicating that changes to a file can be ignored when item is saved or reloaded.
Init ( string fileName, string destination, string projectName, __VSCREATEPROJFLAGS createFlags ) : void	Initialize the nested hierarhy node. This methos should be called just after a NestedProjectNode object is created.
IsItemDirty ( uint itemId, IntPtr punkDocData, int &pfDirty ) : int	Determines whether the hierarchy item changed.
NestedProjectNode ( ProjectNode root, ProjectElement element ) : System
OnChanged ( int dispid ) : void	Notifies a sink that the [bindable] property specified by dispID has changed. If dispID is DISPID_UNKNOWN, then multiple properties have changed together. The client (owner of the sink) should then retrieve the current value of each property of interest from the object that generated the notification. In our case we will care about the VSLangProj80.VsProjPropId.VBPROJPROPID_FileName and update the changes in the parent project file.
OnRequestEdit ( int dispid ) : void	Notifies a sink that a [requestedit] property is about to change and that the object is asking the sink how to proceed.
ReloadItem ( uint reserved ) : void	Delegates the call to the inner hierarchy.
SaveItem ( VSSAVEFLAGS dwSave, string silentSaveAsName, uint itemid, IntPtr punkDocData, int &pfCancelled ) : int	Saves the hierarchy item to disk.
SetEditLabel ( string label ) : int	Called by the shell when a node has been renamed from the GUI

Защищенные методы

Метод	Описание
CanDeleteItem ( __VSDELETEITEMOPERATION deleteOperation ) : bool	This is temporary until we have support for re-adding a nested item
ConnectPropertyNotifySink ( ) : void	We need to advise property notify sink on project properties so that we know when the project file is renamed through a property.
CreateProjectDirectory ( ) : void	Creates the project directory if it does not exist.
DelegateGetPropertyToNested ( int propID ) : object	Delegates GetProperty calls to the inner nested.
DelegateSetPropertyToNested ( int propID, object value ) : int	Delegates SetProperty calls to the inner nested.
DisconnectPropertyNotifySink ( ) : void	Disconnects the PropertyNotify sink
Dispose ( bool disposing ) : void	The method that does the cleanup.
GetConnectionPointFromPropertySink ( ) : IConnectionPoint	Gets a ConnectionPoint for the IPropertyNotifySink interface.
IgnoreNestedProjectFile ( bool ignoreFlag ) : void	Ignores observing changes on this file depending on the boolean flag.
InitImageHandler ( ) : void
InitializeInstanceGuid ( ) : void
ObserveNestedProjectFile ( ) : void	Starts observing changes on this file.
RenameNestedProjectInParentProject ( string label ) : void	Renames the project file in the parent project structure.
SaveNestedProjectItemInProjectFile ( string newFileName ) : void	Saves the nested project information in the project file.
SetDocCookieOnNestedHier ( uint itemDocCookie ) : void
StopObservingNestedProjectFile ( ) : void	Stops observing changes on this file.

Приватные методы

Метод	Описание
LockRdtEntry ( ) : void
UnlockRdtEntry ( ) : void

Описание методов

AddVirtualProject() публичный Метод

Links a nested project as a virtual project to the solution.

public AddVirtualProject ( ) : void
Результат	void

CanDeleteItem() защищенный Метод

This is temporary until we have support for re-adding a nested item

protected CanDeleteItem ( __VSDELETEITEMOPERATION deleteOperation ) : bool
deleteOperation	__VSDELETEITEMOPERATION
Результат	bool

Close() публичный Метод

Return S_OK. Implementation of Closing a nested project is done in CloseNestedProject which is called by CloseChildren.

public Close ( ) : int
Результат	int

CloseNestedProjectNode() публичный Метод

Closes a nested project and releases the nested hierarchy pointer.

public CloseNestedProjectNode ( ) : void
Результат	void

ConnectPropertyNotifySink() защищенный Метод

We need to advise property notify sink on project properties so that we know when the project file is renamed through a property.

protected ConnectPropertyNotifySink ( ) : void
Результат	void

CreateProjectDirectory() защищенный Метод

Creates the project directory if it does not exist.

protected CreateProjectDirectory ( ) : void
Результат	void

DelegateGetPropertyToNested() защищенный Метод

Delegates GetProperty calls to the inner nested.

protected DelegateGetPropertyToNested ( int propID ) : object
propID	int	The property to delegate.
Результат	object

DelegateSetPropertyToNested() защищенный Метод

Delegates SetProperty calls to the inner nested.

protected DelegateSetPropertyToNested ( int propID, object value ) : int
propID	int	The property to delegate.
value	object	The property to set.
Результат	int

DisconnectPropertyNotifySink() защищенный Метод

Disconnects the PropertyNotify sink

protected DisconnectPropertyNotifySink ( ) : void
Результат	void

Dispose() защищенный Метод

The method that does the cleanup.

protected Dispose ( bool disposing ) : void
disposing	bool
Результат	void

GetAddFileFlags() публичный Метод

Sets the VSADDFILEFLAGS that will be used to call the IVsTrackProjectDocumentsEvents2 OnAddFiles

public GetAddFileFlags ( string files ) : VSADDFILEFLAGS[]
files	string	The files to which an array of VSADDFILEFLAGS has to be specified.
Результат	VSADDFILEFLAGS[]

GetAutomationObject() публичный Метод

Get the automation object for the NestedProjectNode

public GetAutomationObject ( ) : object
Результат	object

GetConnectionPointFromPropertySink() защищенный Метод

Gets a ConnectionPoint for the IPropertyNotifySink interface.

protected GetConnectionPointFromPropertySink ( ) : IConnectionPoint
Результат	IConnectionPoint

GetEditLabel() публичный Метод

Called by the shell to get the node caption when the user tries to rename from the GUI

public GetEditLabel ( ) : string
Результат	string

GetGuidProperty() публичный Метод

Gets properties whose values are GUIDs.

public GetGuidProperty ( int propid, System.Guid &guid ) : int
propid	int	Identifier of the hierarchy property
guid	System.Guid	Pointer to a GUID property specified in propid
Результат	int

GetIconHandle() публичный Метод

Gets the icon handle. It tries first the nested to get the icon handle. If that is not supported it will get it from the image list of the nested if that is supported. If neither of these is supported a default image will be shown.

public GetIconHandle ( bool open ) : object
open	bool
Результат	object

GetMKDocument() публичный Метод

Returns the moniker of the nested project.

public GetMKDocument ( ) : string
Результат	string

GetProperty() публичный Метод

Gets properties of a given node or of the hierarchy.

public GetProperty ( int propId ) : object
propId	int	Identifier of the hierarchy property
Результат	object

GetQueryAddFileFlags() публичный Метод

Sets the VSQUERYADDFILEFLAGS that will be used to call the IVsTrackProjectDocumentsEvents2 OnQueryAddFiles

public GetQueryAddFileFlags ( string files ) : VSQUERYADDFILEFLAGS[]
files	string	The files to which an array of VSADDFILEFLAGS has to be specified.
Результат	VSQUERYADDFILEFLAGS[]

GetQueryRemoveFileFlags() публичный Метод

Sets the VSQUERYREMOVEFILEFLAGS that will be used to call the IVsTrackProjectDocumentsEvents2 OnQueryRemoveFiles

public GetQueryRemoveFileFlags ( string files ) : VSQUERYREMOVEFILEFLAGS[]
files	string	The files to which an array of VSQUERYREMOVEFILEFLAGS has to be specified.
Результат	VSQUERYREMOVEFILEFLAGS[]

GetRemoveFileFlags() публичный Метод

Sets the VSREMOVEFILEFLAGS that will be used to call the IVsTrackProjectDocumentsEvents2 OnRemoveFiles

public GetRemoveFileFlags ( string files ) : VSREMOVEFILEFLAGS[]
files	string	The files to which an array of VSREMOVEFILEFLAGS has to be specified.
Результат	VSREMOVEFILEFLAGS[]

IgnoreItemFileChanges() публичный Метод

Flag indicating that changes to a file can be ignored when item is saved or reloaded.

public IgnoreItemFileChanges ( bool ignoreFlag ) : void
ignoreFlag	bool	Flag indicating whether or not to ignore changes (1 to ignore, 0 to stop ignoring).
Результат	void

IgnoreNestedProjectFile() защищенный Метод

Ignores observing changes on this file depending on the boolean flag.

protected IgnoreNestedProjectFile ( bool ignoreFlag ) : void
ignoreFlag	bool	Flag indicating whether or not to ignore changes (1 to ignore, 0 to stop ignoring).
Результат	void

Init() публичный Метод

Initialize the nested hierarhy node.

This methos should be called just after a NestedProjectNode object is created.

public Init ( string fileName, string destination, string projectName, __VSCREATEPROJFLAGS createFlags ) : void
fileName	string	The file name of the nested project.
destination	string	The location of the nested project.
projectName	string	The name of the project.
createFlags	__VSCREATEPROJFLAGS	The nested project creation flags
Результат	void

InitImageHandler() защищенный Метод

protected InitImageHandler ( ) : void
Результат	void

InitializeInstanceGuid() защищенный Метод

protected InitializeInstanceGuid ( ) : void
Результат	void

IsItemDirty() публичный Метод

Determines whether the hierarchy item changed.

public IsItemDirty ( uint itemId, IntPtr punkDocData, int &pfDirty ) : int
itemId	uint	Item identifier of the hierarchy item contained in VSITEMID
punkDocData	System.IntPtr	Pointer to the IUnknown interface of the hierarchy item.
pfDirty	int	TRUE if the hierarchy item changed.
Результат	int

NestedProjectNode() публичный Метод

public NestedProjectNode ( ProjectNode root, ProjectElement element ) : System
root	ProjectNode
element	ProjectElement
Результат	System

ObserveNestedProjectFile() защищенный Метод

Starts observing changes on this file.

protected ObserveNestedProjectFile ( ) : void
Результат	void

OnChanged() публичный Метод

Notifies a sink that the [bindable] property specified by dispID has changed. If dispID is DISPID_UNKNOWN, then multiple properties have changed together. The client (owner of the sink) should then retrieve the current value of each property of interest from the object that generated the notification. In our case we will care about the VSLangProj80.VsProjPropId.VBPROJPROPID_FileName and update the changes in the parent project file.

public OnChanged ( int dispid ) : void
dispid	int	Dispatch identifier of the property that is about to change or DISPID_UNKNOWN if multiple properties are about to change.
Результат	void

OnRequestEdit() публичный Метод

Notifies a sink that a [requestedit] property is about to change and that the object is asking the sink how to proceed.

public OnRequestEdit ( int dispid ) : void
dispid	int	Dispatch identifier of the property that is about to change or DISPID_UNKNOWN if multiple properties are about to change.
Результат	void

ReloadItem() публичный Метод

Delegates the call to the inner hierarchy.

public ReloadItem ( uint reserved ) : void
reserved	uint	Reserved parameter defined at the IVsPersistHierarchyItem2::ReloadItem parameter.
Результат	void

RenameNestedProjectInParentProject() защищенный Метод

Renames the project file in the parent project structure.

protected RenameNestedProjectInParentProject ( string label ) : void
label	string	The new label.
Результат	void

SaveItem() публичный Метод

Saves the hierarchy item to disk.

public SaveItem ( VSSAVEFLAGS dwSave, string silentSaveAsName, uint itemid, IntPtr punkDocData, int &pfCancelled ) : int
dwSave	VSSAVEFLAGS	Flags whose values are taken from the VSSAVEFLAGS enumeration.
silentSaveAsName	string	File name to be applied when dwSave is set to VSSAVE_SilentSave.
itemid	uint	Item identifier of the hierarchy item saved from VSITEMID.
punkDocData	System.IntPtr	Pointer to the IUnknown interface of the hierarchy item saved.
pfCancelled	int	TRUE if the save action was canceled.
Результат	int

SaveNestedProjectItemInProjectFile() защищенный Метод

Saves the nested project information in the project file.

protected SaveNestedProjectItemInProjectFile ( string newFileName ) : void
newFileName	string
Результат	void

SetDocCookieOnNestedHier() защищенный Метод

protected SetDocCookieOnNestedHier ( uint itemDocCookie ) : void
itemDocCookie	uint
Результат	void

SetEditLabel() публичный Метод

Called by the shell when a node has been renamed from the GUI

public SetEditLabel ( string label ) : int
label	string	The name of the new label.
Результат	int

StopObservingNestedProjectFile() защищенный Метод

Stops observing changes on this file.

protected StopObservingNestedProjectFile ( ) : void
Результат	void