L_AnnGetTextRTF

#include "l_bitmap.h"

L_LTANN_API L_INT L_AnnGetTextRTF(hObject, uFormat, pText, puLen)

HANNOBJECT hObject;	handle to the annotation object
L_UINT uFormat;	text format type
L_TCHAR * pText;	address of character string to be updated
L_SIZE_T * puLen;	address of a variable to be updated

Gets the text and text length (unformatted text or rich text) of an ANNOBJECT_RTF or ANNOBJECT_AUTOMATION annotation object.

Parameter	Description
hObject	Handle to the ANNOBJECT_RTF object.
uFormat	Value that specifies the text format type. Possible values are:
	Value	Meaning
	RTFFORMAT_TEXT	[0x0001] Retrieve the text as unformatted text.
	RTFFORMAT_RTF	[0x0002] Retrieve the text as rich text.
pText	Pointer to a character string to be updated with the annotation object's character string. This value can be NULL.
puLen	Address of the variable to be updated with the length of the object's character string.

Returns

SUCCESS	The function was successful.
< 1	An error occurred. Refer to Return Codes.

Comments

This function is used to retrieve the text from an ANNOBJECT_RTF or ANNOBJECT_AUTOMATION object. The text can be retrieved either as rich text, or unformatted text.

Call this function twice. On the first call, pass NULL for the pText argument to get length of the required input buffer. Then, allocate a buffer and call the function a second time to retreive the text. The following code snippet illustrates the process:

   HANNOBJECT hObject;  // assume this is a valid ANNOBJECT_RTF object   
   L_UINT uLength;   
   L_TCHAR *pText;   
   // Get the length   
   L_AnnGetTextRTF( hObject, RTFFORMAT_RTF, NULL, &uLength);   
   // Allocate a buffer   
   pText = (L_TCHAR *)malloc ( (uLength+1) * sizeof (L_TCHAR) );   
   // Retrieve the text   
   L_AnnGetTextRTF( hObject, RTFFORMAT_RTF, pText, &uLength);

To get or set the text of other text objects, see the documentation for L_AnnGetTextLen, L_AnnGetText and L_AnnSetText.

Required DLLs and Libraries

LTANN

For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application.

Platforms

Win32, x64.

Example

This sample gets the text from Rich Text annotation object in one of two formats (text, or rich text) hObject: the Rich Text annotation object uFormat: the format of the retrieved text--one of RTFFORMAT_TEXT RTFFORMAT_RTF

L_INT AnnGetTextRTFExample(HANNOBJECT hObject, 
L_UINT     uFormat) 
{ 
   L_INT nRet; 
   L_SIZE_T zLength; 
   L_TCHAR* pText; 
   L_TCHAR  szMsg[200]; 
   L_TCHAR* pszFormat; 
   switch(uFormat) 
   { 
      case RTFFORMAT_TEXT: 
      pszFormat = TEXT("RTFFORMAT_TEXT"); 
      break; 
      case RTFFORMAT_RTF: 
      pszFormat = TEXT("RTFFORMAT_RTF"); 
      break; 
default: 
      return 0; 
      break; 
   } 
   // Get the length 
   nRet = L_AnnGetTextRTF( hObject, uFormat, NULL, &zLength); 
   if (nRet != SUCCESS) 
      return nRet; 
   pText = (L_TCHAR *)malloc( (zLength + 1) * sizeof(L_TCHAR) ); 
   nRet = L_AnnGetTextRTF( hObject, uFormat, pText, &zLength); 
   if (nRet == SUCCESS) 
   { 
      wsprintf(szMsg, TEXT("Format: %s\nLength: %d"), pszFormat, zLength); 
      MessageBox(NULL, szMsg, TEXT("L_AnnGetTextRTF")/*pText, szMsg*/, MB_OK); 
   } 
   else 
   { 
      return nRet; 
   } 
   free(pText); 
   return SUCCESS; 
}

Help Version 19.0.2017.10.27

Products | Support | Contact Us | Copyright Notices
© 1991-2017 LEAD Technologies, Inc. All Rights Reserved.

LEADTOOLS Raster Imaging C API Help

Introduction

Version History

Getting Started

LEADTOOLS Raster Imaging Features

Redistributables/Files To Be Included With Your Application

Functions:	L_AnnGetText, L_AnnSetText, L_AnnGetTextLen, L_AnnGetAutoText, L_AnnGetAutoTextLen, L_AnnSetAutoText, L_AnnSetTextRTF
Topics:	Annotation Functions: Object Properties
	Annotation Objects - Default Values
	Annotation Objects - Automated Features
	Implementing an Automated Annotation Program
	Implementing a Non-automated Annotation Program
	Obtaining Annotation Object Information