#include "ltivw.h"
L_LTIVW_API L_INT L_DispContainerBurnTag(pBitmap, uRow, uAlign, pString, pFontFamily, nFontStyle, fFontSize, bShadow, nShadowColor, nColor, uFlags)
Burns the tag onto the bitmap.
Pointer to the bitmap handle of the bitmap on which the tag is burned.
A zero-based index representing the line at which the overlay text will be drawn.
Value that specifies the origin point from which to count the rows specified in the uRow parameter. For example, if uAlign is DISPWIN_ALIGN_BOTTOMLEFT and uRow is 4, the tag is placed counting 4 rows from the bottom. Possible values are:
Value | Meaning |
---|---|
DISPWIN_ALIGN_TOPLEFT | [0x0000] Start counting rows from the top of the cell. The tag is left-justified. |
DISPWIN_ALIGN_LEFTCENTER | [0x0001] The tag is placed in the center, based on the height of the cell, and is left-justified. |
DISPWIN_ALIGN_BOTTOMLEFT | [0x0002] Start counting rows from the bottom of the cell. The tag is left-justified. |
DISPWIN_ALIGN_TOPCENTER | [0x0003] The tag is placed in the center, based on the width of the cell, and is top-justified. |
DISPWIN_ALIGN_BOTTOMCENTER | [0x0004] The tag is placed in the center, based on the width of the cell, and is bottom-justified. |
DISPWIN_ALIGN_TOPRIGHT | [0x0005] Start counting rows from the top of the cell. The tag is right-justified. |
DISPWIN_ALIGN_RIGHTCENTER | [0x0006] The tag is placed in the center, based on the height of the cell, and is right-justified. |
DISPWIN_ALIGN_BOTTOMRIGHT | [0x0007] Start counting rows from the bottom of the cell. The tag is right-justified. |
A character string specifying the tag's text.
Pointer to variable specifying the font family to which the font belongs.
A variable specifying the font style of the text.
A variable specifying the font size of the text.
A boolean flag that indicates whether to include text shadowing in the burn process. Possible values are:
Value | Meaning |
---|---|
TRUE | Include text shadowing in the burn process. |
FALSE | Exclude the text shadow in the burn process. |
A variable specifying the color of the text's shadow.
A variable specifying the color of the text.
Reserved for future use. Pass zero.
Value | Meaning |
---|---|
SUCCESS | The function was successful. |
< 1 | An error occurred. Refer to Return Codes. |
The image data can change if the user calls this function.
Required DLLs and Libraries
LTIVW
For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application.
This function burns a text string to the viewer's bitmap.
L_INT DispContainerBurnTagExample(HDISPCONTAINER hCon)
{
BITMAPHANDLE Bitmap;
L_INT nRet;
L_INT nCellIndex = 0;
HWND hCellWnd = L_DispContainerGetCellWindowHandle(hCon, nCellIndex, 0);
// Just burn using the bitmap in the active sub-cell.
// this is done by setting the nSubCell parameter to -2.
nRet = L_DispContainerGetBitmapHandle(hCellWnd, -2, &Bitmap, 0);
if (nRet != SUCCESS)
return nRet;
nRet = L_DispContainerBurnTag(&Bitmap, 0, DISPWIN_ALIGN_BOTTOMCENTER, L_TEXT("My Sample Text"), L_TEXT("Arial"), 0, 12, TRUE, RGB(128, 128, 128), RGB(255, 255, 255), 0);
if (nRet != SUCCESS)
return nRet;
nRet = L_DispContainerSetBitmapHandle(hCellWnd, -2, &Bitmap, FALSE, 0);
if (nRet != SUCCESS)
return nRet;
// Repaint the cell after the user is done with the changes.
nRet = L_DispContainerRepaintCell(hCellWnd, 0);
if (nRet != SUCCESS)
return nRet;
return SUCCESS;
}