IMsRdpClientAdvancedSettings::get_ShadowBitmap (Windows Embedded CE 6.0)

1/6/2010

This method retrieves a value that indicates whether shadow bitmaps will be used.

Syntax

HRESULT get_ShadowBitmap( 
    LONG *pshadowBitmap
);

Parameters

• pshadowBitmap
  [out] If this feature is disabled, this parameter is 0. If this feature is enabled, this parameter is a nonzero value.

Return Value

Returns S_OK if successful.

Remarks

A shadow bitmap effect applies a shadow behind a visual object at a slight offset. A shadow bitmap effect makes the UI element appear like it is lifting off the surface of the display screen.

When in full-screen mode, shadow bitmaps can be used if the full-screen window size is smaller than the desktop size. Otherwise, shadow bitmaps are unavailable in full-screen mode.

A nonzero value enables shadowing, while a value of zero makes it unavailable. Disabling the ShadowBitmap property typically improves performance but can result in artifacts when painting bitmaps on the display screen.

Requirements

See Also

Reference

IMsRdpClientAdvancedSettings Methods for Bitmaps and Caching
IMsRdpClientAdvancedSettings
IMsRdpClientAdvancedSettings::put_ShadowBitmap