L_AnnTextEdit

Summary

This function causes a text-based annotation to enter edit mode.

Syntax

#include "l_bitmap.h"

L_LTANN_API L_INT L_AnnTextEdit (hObject);

Parameters

HANNOBJECT hObject

Handle to the text-based annotation object.

Returns

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

Comments

This function causes a text-based annotation to enter edit mode, which displays an edit window for direct entry of text. Calling this function allows a user to programmatically force an object into edit mode - an action that is normally available in automation mode when creating or double-clicking text-based annotations.

It can be used with any of the text-based annotations including:

A successful call to L_AnnSetText() affects hObject in the following way:

Only one object can be in text edit mode. Therefore, if another text object is in text edit mode (hObject2), calling L_AnnTextEdit(), will get hObject2 out of the text edit mode, and put hObject into the text edit mode.

This function will fail with ERROR_AUTOMATION_INV_HANDLE if hObject is not contained in the root container and if it is not in the automated mode.

This function works only with the following objects:

If you pass an object that is not one of these types, the function will return ERROR_INV_PARAMETER.

Required DLLs and Libraries

Platforms

Win32, x64.

See Also

Functions

Topics

Example

This example programmatically makes an annotation text object
hObject go into edit mode.
Note that hObject must be a annotation.

L_INT AnnTextEditExample(HANNOBJECT hObject) 
{ 
   L_INT    nRet = SUCCESS; 
   L_TCHAR* pszError = NULL; 
 
   nRet = L_AnnTextEdit(hObject); 
   switch (nRet) 
   { 
   case SUCCESS: 
      pszError = NULL; 
      break; 
   case ERROR_AUTOMATION_INV_HANDLE: 
      pszError = TEXT("Error: L_AnnTextEdit failed because you are not in automated mode"); 
      break; 
   case ERROR_INV_PARAMETER: 
      pszError = TEXT("Error: L_AnnTextEdit failed because hObject was not text-based"); 
      break; 
   default: 
      pszError = TEXT("Error: L_AnnTextEdit failed"); 
      break; 
   } 
 
   if (pszError) 
      _tprintf(_T("%s"), pszError); 
 
   return nRet; 
} 

Help Version 22.0.2023.7.11
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2023 LEAD Technologies, Inc. All Rights Reserved.

LEADTOOLS Raster Imaging C API Help
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2023 LEAD Technologies, Inc. All Rights Reserved.