GreCharRect

GreCharRect draws a rectangle of character cells from the LVB to the device context. The attributes for each character are applied by the handling routine as the character is drawn.


 * Simulation support: This function is mandatory for display drivers. For other drivers, it is simulated by a handling routine in the graphics engine.

Syntax
GreCharRect(hdc, pVioPS, pCharRect, pInstance, lFunction)

Parameters

 * hdc (HDC) - input:The device context handle.
 * pVioPS (VioPresentationSpace *) - input:A pointer to the Vio presentation space.
 * pCharRect (LPGridRectRef) - input:A pointer to a parameter block. This is a GridRectRef structure:
 * StartRow The starting row (relative to the bottom left of the LVB) of the character rectangle to be drawn
 * StartCol The starting column (relative to the bottom left of the LVB) of the character rectangle to be drawn
 * RectWidth The width in character cells of the rectangle to be updated
 * RectHeight The height of the rectangle to be updated


 * pInstance (PVOID) - input:A pointer to instance data.
 * lFunction (ULONG) - input:High-order WORD=flags; low-order WORD=NGreCharRect.

Returns

 * rc (LONG) - returns:Return codes.
 * This function returns a LONG value as an error indicator.
 * NO_ERROR Successful.
 * CE_INVALID_PRESENTATION_SPACE Error. For example, this message might be returned as a result of an invalid CellByteSize.

Remarks
This function is used to implement the advanced Vio function, VioSetOrg.