GetCharacterPlacementW(3w)

GetCharacterPlacementW3w

Usage

DWORD GetCharacterPlacementW
(
HDC hdc,
LPCWSTR lpString,
INT uCount,
INT nMaxExtent,
GCP_RESULTSW* lpResults,
DWORD dwFlags
)

Params

hdc [In] Device context for which the rendering is to be done.

lpString [In] The string for which information is to be returned.

uCount [In] Number of WORDS in string.

nMaxExtent [In] Maximum extent the string is to take (in HDC logical units).

lpResults [In/Out] A pointer to a GCP_RESULTSW struct.

[In] Flags specifying how to process the string.

Overview

Retrieve information about a string. This includes the width, reordering, Glyphing and so on.

Returns

The width and height of the string if successful, 0 if failed.

Implementation

Declared in "wingdi.h".

Implemented in "dlls/gdi32/font.c".

Debug channel "font".

Releases

5 releases since Debian 2.1 (Slink); the text changed 4 times.

  1. 2.1
  2. 4.0
  3. 5.0
  4. 6.0
  5. 7

Bugs

All flags except GCP_REORDER are not yet implemented. Reordering is not 100% compliant to the Windows(tm) BiDi method. Caret positioning is not yet implemented for BiDi. Classes are not yet implemented.

From libwine-dev 1.4.1-4 in Debian 7 (Wheezy). Parsed by carta from the page's man source.