C# Class VSNDK.DebugEngine.AD7Property

Inheritance: IDebugProperty2

Mostrar archivo Open project: blackberry/VSPlugin Class Usage Examples

Public Methods

Method	Description
AD7Property ( AD7StackFrame vi ) : System	Constructor.
AD7Property ( VariableInfo vi ) : System	Constructor.
ConstructDebugPropertyInfo ( enum_DEBUGPROP_INFO_FLAGS dwFields ) : DEBUG_PROPERTY_INFO	Construct a DEBUG_PROPERTY_INFO representing this local or parameter.
EnumChildren ( enum_DEBUGPROP_INFO_FLAGS dwFields, uint dwRadix, System &guidFilter, enum_DBG_ATTRIB_FLAGS dwAttribFilter, string pszNameFilter, uint dwTimeout, IEnumDebugPropertyInfo2 &ppEnum ) : int	Enumerates the children of a property. This provides support for dereferencing pointers, displaying members of an array, or fields of a class or struct. (http://msdn.microsoft.com/en-us/library/bb161791.aspx)
GetDerivedMostProperty ( IDebugProperty2 &ppDerivedMost ) : int	Returns the property that describes the most-derived property of a property. (http://msdn.microsoft.com/en-ca/library/bb161781.aspx) This is called to support object oriented languages. It allows the debug engine to return an IDebugProperty2 for the most-derived object in a hierarchy. The VSNDK debug engine does not support this. Not implemented.
GetExtendedInfo ( System &guidExtendedInfo, object &pExtendedInfo ) : int	Returns the extended information of a property. (http://msdn.microsoft.com/en-ca/library/bb145070.aspx) This method exists for the purpose of retrieving information that does not lend itself to being retrieved by calling the IDebugProperty2::GetPropertyInfo method. This includes information about custom viewers, managed type slots and other information. The VSNDK debug engine does not support this. Not implemented.
GetMemoryBytes ( IDebugMemoryBytes2 &ppMemoryBytes ) : int	Returns the memory bytes that compose the value of a property. (http://msdn.microsoft.com/en-ca/library/bb161360.aspx) Not implemented.
GetMemoryContext ( IDebugMemoryContext2 &ppMemory ) : int	Returns the memory context for a property value. (http://msdn.microsoft.com/en-ca/library/bb147028.aspx) Not implemented.
GetParent ( IDebugProperty2 &ppParent ) : int	Returns the parent of a property. (http://msdn.microsoft.com/en-ca/library/bb146184.aspx) Not implemented.
GetPropertyInfo ( enum_DEBUGPROP_INFO_FLAGS dwFields, uint dwRadix, uint dwTimeout, IDebugReference2 rgpArgs, uint dwArgCount, DEBUG_PROPERTY_INFO pPropertyInfo ) : int	Fills in a DEBUG_PROPERTY_INFO structure that describes a property. (http://msdn.microsoft.com/en-ca/library/bb145852.aspx)
GetReference ( IDebugReference2 &ppReference ) : int	Returns a reference to the property's value. IDebugProperty2 represents a property, while IDebugReference2 represents a reference to a property, typically a reference to an object in the program being debugged. Not implemented. (http://msdn.microsoft.com/en-ca/library/bb145600.aspx)
GetSize ( uint &pdwSize ) : int	Returns the size, in bytes, of the property value. Not implemented. (http://msdn.microsoft.com/en-ca/library/bb145093.aspx)
SetValueAsReference ( IDebugReference2 rgpArgs, uint dwArgCount, IDebugReference2 pValue, uint dwTimeout ) : int	Sets the value of the property from the value of a given reference. (http://msdn.microsoft.com/en-ca/library/bb145613.aspx) The debugger will call this when the user tries to edit the property's values. As the sample has set the read-only flag on its properties, this should not be called. Not implemented.
SetValueAsString ( string pszValue, uint dwRadix, uint dwTimeout ) : int	Sets the value of a property from a given string. (http://msdn.microsoft.com/en-ca/library/bb160956.aspx) The debugger will call this when the user tries to edit the property's values in one of the debugger windows.

Method Details

AD7Property() public method

Constructor.

public AD7Property ( AD7StackFrame vi ) : System
vi	AD7StackFrame	Contains all information about a variable / expression.
return	System

AD7Property() public method

Constructor.

public AD7Property ( VariableInfo vi ) : System
vi	VariableInfo	Contains all information about a variable / expression.
return	System

ConstructDebugPropertyInfo() public method

Construct a DEBUG_PROPERTY_INFO representing this local or parameter.

public ConstructDebugPropertyInfo ( enum_DEBUGPROP_INFO_FLAGS dwFields ) : DEBUG_PROPERTY_INFO
dwFields	enum_DEBUGPROP_INFO_FLAGS	A combination of flags from the DEBUGPROP_INFO_FLAGS enumeration that specifies which variables are /// to be filled in.
return	DEBUG_PROPERTY_INFO

EnumChildren() public method

Enumerates the children of a property. This provides support for dereferencing pointers, displaying members of an array, or fields of a class or struct. (http://msdn.microsoft.com/en-us/library/bb161791.aspx)

public EnumChildren ( enum_DEBUGPROP_INFO_FLAGS dwFields, uint dwRadix, System &guidFilter, enum_DBG_ATTRIB_FLAGS dwAttribFilter, string pszNameFilter, uint dwTimeout, IEnumDebugPropertyInfo2 &ppEnum ) : int
dwFields	enum_DEBUGPROP_INFO_FLAGS	A combination of flags from the DEBUGPROP_INFO_FLAGS enumeration that specifies which fields in /// the enumerated DEBUG_PROPERTY_INFO structures are to be filled in.
dwRadix	uint	Specifies the radix to be used in formatting any numerical information.
guidFilter	System	GUID of the filter used with the dwAttribFilter and pszNameFilter parameters to select which /// DEBUG_PROPERTY_INFO children are to be enumerated. For example, guidFilterLocals filters for local variables.
dwAttribFilter	enum_DBG_ATTRIB_FLAGS	A combination of flags from the DBG_ATTRIB_FLAGS enumeration that specifies what type of /// objects to enumerate, for example DBG_ATTRIB_METHOD for all methods that might be children of this property. Used in /// combination with the guidFilter and pszNameFilter parameters.
pszNameFilter	string	The name of the filter used with the guidFilter and dwAttribFilter parameters to select which /// DEBUG_PROPERTY_INFO children are to be enumerated. For example, setting this parameter to "MyX" filters for all children /// with the name "MyX."
dwTimeout	uint	Specifies the maximum time, in milliseconds, to wait before returning from this method. Use /// INFINITE to wait indefinitely.
ppEnum	IEnumDebugPropertyInfo2	Returns an IEnumDebugPropertyInfo2 object containing a list of the child properties.
return	int

GetDerivedMostProperty() public method

Returns the property that describes the most-derived property of a property. (http://msdn.microsoft.com/en-ca/library/bb161781.aspx) This is called to support object oriented languages. It allows the debug engine to return an IDebugProperty2 for the most-derived object in a hierarchy. The VSNDK debug engine does not support this. Not implemented.

public GetDerivedMostProperty ( IDebugProperty2 &ppDerivedMost ) : int
ppDerivedMost	IDebugProperty2	Returns an IDebugProperty2 object that represents the derived-most property.
return	int

GetExtendedInfo() public method

Returns the extended information of a property. (http://msdn.microsoft.com/en-ca/library/bb145070.aspx) This method exists for the purpose of retrieving information that does not lend itself to being retrieved by calling the IDebugProperty2::GetPropertyInfo method. This includes information about custom viewers, managed type slots and other information. The VSNDK debug engine does not support this. Not implemented.

public GetExtendedInfo ( System &guidExtendedInfo, object &pExtendedInfo ) : int
guidExtendedInfo	System	GUID that determines the type of extended information to be retrieved.
pExtendedInfo	object	Returns a VARIANT (C++) or object (C#) that can be used to retrieve the extended property /// information. For example, this parameter might return an IUnknown interface that can be queried for an IDebugDocumentText2 /// interface.
return	int

GetMemoryBytes() public method

Returns the memory bytes that compose the value of a property. (http://msdn.microsoft.com/en-ca/library/bb161360.aspx) Not implemented.

public GetMemoryBytes ( IDebugMemoryBytes2 &ppMemoryBytes ) : int
ppMemoryBytes	IDebugMemoryBytes2	Returns an IDebugMemoryBytes2 object that can be used to retrieve the memory that contains /// the value of the property.
return	int

GetMemoryContext() public method

Returns the memory context for a property value. (http://msdn.microsoft.com/en-ca/library/bb147028.aspx) Not implemented.

public GetMemoryContext ( IDebugMemoryContext2 &ppMemory ) : int
ppMemory	IDebugMemoryContext2	Returns the IDebugMemoryContext2 object that represents the memory associated with this property.
return	int

GetParent() public method

Returns the parent of a property. (http://msdn.microsoft.com/en-ca/library/bb146184.aspx) Not implemented.

public GetParent ( IDebugProperty2 &ppParent ) : int
ppParent	IDebugProperty2	Returns an IDebugProperty2 object that represents the parent of the property.
return	int

GetPropertyInfo() public method

Fills in a DEBUG_PROPERTY_INFO structure that describes a property. (http://msdn.microsoft.com/en-ca/library/bb145852.aspx)

public GetPropertyInfo ( enum_DEBUGPROP_INFO_FLAGS dwFields, uint dwRadix, uint dwTimeout, IDebugReference2 rgpArgs, uint dwArgCount, DEBUG_PROPERTY_INFO pPropertyInfo ) : int
dwFields	enum_DEBUGPROP_INFO_FLAGS	A combination of flags from the DEBUGPROP_INFO_FLAGS enumeration that specifies which fields are to /// be filled out in the pPropertyInfo structure.
dwRadix	uint	Radix to be used in formatting any numerical information.
dwTimeout	uint	Specifies the maximum time, in milliseconds, to wait before returning from this method. Use /// INFINITE to wait indefinitely.
rgpArgs	IDebugReference2	Reserved for future use; set to a null value.
dwArgCount	uint	Reserved for future use; set to zero.
pPropertyInfo	DEBUG_PROPERTY_INFO	A DEBUG_PROPERTY_INFO structure that is filled in with the description of the property.
return	int

GetReference() public method

Returns a reference to the property's value. IDebugProperty2 represents a property, while IDebugReference2 represents a reference to a property, typically a reference to an object in the program being debugged. Not implemented. (http://msdn.microsoft.com/en-ca/library/bb145600.aspx)

public GetReference ( IDebugReference2 &ppReference ) : int
ppReference	IDebugReference2	Returns an IDebugReference2 object representing a reference to the property's value.
return	int

GetSize() public method

Returns the size, in bytes, of the property value. Not implemented. (http://msdn.microsoft.com/en-ca/library/bb145093.aspx)

public GetSize ( uint &pdwSize ) : int
pdwSize	uint	Returns the size, in bytes, of the property value.
return	int

SetValueAsReference() public method

Sets the value of the property from the value of a given reference. (http://msdn.microsoft.com/en-ca/library/bb145613.aspx) The debugger will call this when the user tries to edit the property's values. As the sample has set the read-only flag on its properties, this should not be called. Not implemented.

public SetValueAsReference ( IDebugReference2 rgpArgs, uint dwArgCount, IDebugReference2 pValue, uint dwTimeout ) : int
rgpArgs	IDebugReference2	An array of arguments to pass to the managed code property setter. If the property setter does not /// take arguments or if this IDebugProperty2 object does not refer to such a property setter, rgpArgs should be a null value. /// This parameter is typically a null value.
dwArgCount	uint	The number of arguments in the rgpArgs array.
pValue	IDebugReference2	A reference, in the form of an IDebugReference2 object, to the value to use to set this property.
dwTimeout	uint	How long to take to set the value, in milliseconds. A typical value is INFINITE. This affects /// the length of time that any possible evaluation can take.
return	int

SetValueAsString() public method

Sets the value of a property from a given string. (http://msdn.microsoft.com/en-ca/library/bb160956.aspx) The debugger will call this when the user tries to edit the property's values in one of the debugger windows.

public SetValueAsString ( string pszValue, uint dwRadix, uint dwTimeout ) : int
pszValue	string	A string containing the value to be set.
dwRadix	uint	A radix to be used in interpreting any numerical information. This can be 0 to attempt to determine /// the radix automatically.
dwTimeout	uint	Specifies the maximum time, in milliseconds, to wait before returning from this method. Use /// INFINITE to wait indefinitely.
return	int