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