Share via

PHDrawBackground (Windows Embedded CE 6.0)

  • Article

1/6/2010

This API draws the common background for all applications in the IP Phone Suite. The API draws a background rectangle using a bitmap, a gradient fill or a simple color.

Syntax

BOOL PHDrawBackground(
HDC hdc,
RECT* pDrawRectangle
);

Parameters

  • hdc
    [in] A handle to a valid device context (DC).
  • pDrawRectangle
    [in] A pointer to a RECT. It will be the dimensions of the drawing surface.

Return Value

This API returns TRUE or FALSE to indicated success or failure. The following table shows additional possible return values. To get extended error information, call GetLastError.

Value Description

ERROR_INVALID_PARAMETER

Either the DC or the RECT passed to the function is invalid.

Remarks

Note

This documentation applies to functionality implemented in sample code for PhCommon. For more information, see PhCommon Reference.

The code is currently set to either do a gradient fill or a simple background. You can modify the source code to take advantage of the bitmap-as-background code.

Requirements

Header controldefinitions.h
Library PhCommon.dll
Windows Embedded CE Windows Embedded CE 6.0 and later

See Also

Reference

PhCommon Controls APIs
PhCommon Reference