In This Topic ▼

LAnnStamp::GetText

Summary

Gets the text (character string) of the annotation object.

Syntax

#include "ltwrappr.h"

virtual L_INT LAnnStamp::GetText(pText, puLen)

Parameters

L_TCHAR * pText

Character string to be updated with the annotation object's character string.

L_SIZE_T *puLen

Pointer to a variable to updated with the text length.

Returns

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

Comments

Before calling this function, you must declare a variable as a pointer to a character string. Then, pass the variable in the pText parameter. This function will update the variable with the annotation object's character string.

The LAnnStamp class gets and sets text without formatting. Use the LAnnRTF class to use formatted text.

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

L_INT LAnnStamp_GetTextExample(LAnnStamp  * pAnnObject) 
{ 
	L_INT nRet; 
 
   L_TCHAR  * pText; /* The object’s text */ 
   HGLOBAL hText; /* Handle for memory management */ 
   L_SIZE_T  TextLength; /* Length of the object’s text */ 
    
   /* Get the length of the current text */ 
   TextLength = pAnnObject->GetTextLen(); 
   /* Add six characters to the length for our new text */ 
   TextLength += 6; 
 
    /* Allocate and lock a zero-filled buffer for the text */ 
   hText = GlobalAlloc(GPTR,TextLength * sizeof(L_TCHAR)); 
   pText = (L_TCHAR  *)GlobalLock( hText ); 
   /* Get the current text */ 
   nRet = pAnnObject->GetText(pText,&TextLength); 
	if(nRet != SUCCESS) 
		return nRet; 
   /* Add " - New" to the end of the current text */ 
   lstrcat(pText,TEXT(" - New")); 
   nRet = pAnnObject->SetText(pText, 0); 
	if(nRet != SUCCESS) 
		return nRet; 
    
   /* Free memory that we no longer need */ 
   GlobalFree(hText);    
 
	return SUCCESS; 
}