GreCharRect
From EDM2
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.
Contents
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.