Win_CreateCompatibleDC

<< Click to Display Table of Contents >>

Navigation:  ThinBASIC Modules > UI (User Interface) > Windows API >

Win_CreateCompatibleDC

 

Description

 

Creates a memory device context (DC) compatible with the specified device.

 

Syntax

 

hDC = Win_CreateCompatibleDC(hDC)

 

Returns

 

Number.

If the function succeeds, the return value is the handle to a memory DC.

If the function fails, the return value is NULL.

 

Parameters

 

Name

Type

Optional

Meaning

hDC

Number

No

A handle to an existing DC. If this handle is NULL, the function creates a memory DC compatible with the application's current screen.

 

Remarks

 

A memory DC exists only in memory. When the memory DC is created, its display surface is exactly one monochrome pixel wide and one monochrome pixel high. Before an application can use a memory DC for drawing operations, it must select a bitmap of the correct width and height into the DC. To select a bitmap into a DC, use the Win_CreateCompatibleBitmap function, specifying the height, width, and color organization required.

 

When a memory DC is created, all attributes are set to normal default values. The memory DC can be used as a normal DC. You can set the attributes; obtain the current settings of its attributes; and select pens, brushes, and regions.

 

 

Restrictions

 

See also

 

Examples