virtual L_INT LAnnRTF::GetText(pText, puLen)
Gets the text (character string) of the annotation object.
Character string to be updated with the annotation object's character string.
Pointer to a variable to updated with the text length.
Value | Meaning |
---|---|
SUCCESS | The function was successful. |
< 1 | An error occurred. Refer to Return Codes. |
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.
GetText can be used to retreive text that was set using LAnnRTF::SetTextRTF, but no formatting information will be preserved. To retrieve the text with formatting, use LAnnRTF::GetTextRTF.
Win32, x64.
L_INT LAnnRTF_GetTextExample(LAnnRTF * 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;
}
Help Collections
Raster .NET | C API | C++ Class Library | HTML5 JavaScript
Document .NET | C API | C++ Class Library | HTML5 JavaScript
Medical .NET | C API | C++ Class Library | HTML5 JavaScript
Medical Web Viewer .NET
Multimedia
Direct Show .NET | C API | Filters
Media Foundation .NET | C API | Transforms
Supported Platforms
.NET, Java, Android, and iOS/macOS Assemblies
Imaging, Medical, and Document
C API/C++ Class Libraries
Imaging, Medical, and Document
HTML5 JavaScript Libraries
Imaging, Medical, and Document