IVsFontAndColorUtilities.EncodeTrackedItem Method
Returns a RGB (COLORREF) color value corresponding to a color tracked in the Visual Studio environment.
Namespace: Microsoft.VisualStudio.Shell.Interop
Assembly: Microsoft.VisualStudio.Shell.Interop.8.0 (in Microsoft.VisualStudio.Shell.Interop.8.0.dll)
Syntax
'Declaration
Function EncodeTrackedItem ( _
iItemToTrack As Integer, _
aspect As Integer, _
<OutAttribute> ByRef pcrResult As UInteger _
) As Integer
int EncodeTrackedItem(
int iItemToTrack,
int aspect,
out uint pcrResult
)
int EncodeTrackedItem(
[InAttribute] int iItemToTrack,
[InAttribute] int aspect,
[OutAttribute] unsigned int% pcrResult
)
abstract EncodeTrackedItem :
iItemToTrack:int *
aspect:int *
pcrResult:uint32 byref -> int
function EncodeTrackedItem(
iItemToTrack : int,
aspect : int,
pcrResult : uint
) : int
Parameters
iItemToTrack
Type: Int32[in] An index indicating a visual component whose color must be tracked.
aspect
Type: Int32[in] A member of the __VSCOLORASPECT enumeration.
pcrResult
Type: UInt32%[out] A COLORREF representation corresponding to the color of the aspect of the tracked visual component.
Return Value
Type: Int32
If the method succeeds, it returns S_OK. If it fails, it returns an error code.
Remarks
The member of the __VSCOLORASPECT enumeration supplied as the aspect argument indicates if the foreground or background color of the tracked item is to be used.
The value of pcrResult returned indicates that the component's color is being tracked and that its value may change.
If aspect has a value of CA_BACKGROUND the COLORREF will have a type of CT_TRACK_BACKGROUND as returned by the GetColorType method.
If aspect has a value of CA_FOREGROUND the COLORREF will have a type of CT_TRACK_FOREGROUND.
Managed code can obtain functionality equivalent to GetSysColor with SystemColors and convert between COLORREF and the System.Drawing.Color structure using M:System.Drawing.ColorTranslator.FromWin32 and M:System.Drawing.ColorTranslator.ToWin32.
.NET Framework Security
- Full trust for the immediate caller. This member cannot be used by partially trusted code. For more information, see Using Libraries from Partially Trusted Code.
See Also
Reference
IVsFontAndColorUtilities Interface
Microsoft.VisualStudio.Shell.Interop Namespace