L_AnnGetTextRotate
#include "l_bitmap.h"
L_LTANN_API L_INT L_AnnGetTextRotate(hObject, puTextRotate)
HANNOBJECT hObject; |
/* handle to the annotation object */ |
L_UINT *puTextRotate; |
/* address of variable to be updated */ |
Gets a value that indicates whether the text of an annotation object is rotated.
Parameter |
Description |
|
hObject |
Handle to the annotation object. |
|
puTextRotate |
Address of the variable to be updated with a value that indicates whether the text is rotated, and if so, by how many degrees. Possible values are: |
|
|
Value |
Meaning |
|
TEXTROTATE_0 |
[0] Do not rotate the text. |
|
TEXTROTATE_90 |
[90] The text is rotated 90 degrees counter clockwise. |
|
TEXTROTATE_180 |
[180] The text is rotated 180 degrees counter clockwise. |
|
TEXTROTATE_270 |
[270] The text is rotated 270 degrees counter clockwise. |
Returns
SUCCESS |
The function was successful. |
< 1 |
An error occurred. Refer to Return Codes. |
Comments
This function is valid only for the following annotation objects:
ANNOBJECT_AUTOMATION
ANNOBJECT_NOTE
ANNOBJECT_TEXTPOINTER
Calling this function on an object other than those listed above will return ERROR_FEATURE_NOT_SUPPORTED.
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. |
Win32, x64.
See Also
Functions: |
L_AnnSetTextRotate, L_AnnGetTextFixedSize, L_AnnSetTextFixedSize |
Topics: |
|
|
Annotation Functions (Document/Medical only): Text Properties |
Example
Sample for L_AnnSetTextRotate, L_AnnGetTextRotate. This Example changes the text rotation of a note or text pointer annotation.
L_INT AnnGetTextRotateExample(HANNOBJECT hObject) { L_INT nRet; L_UINT uTextRotate; L_TCHAR szMsg[100]; L_UINT uType; L_AnnGetTextRotate(hObject, &uTextRotate); switch(uTextRotate) { case TEXTROTATE_0: uTextRotate = TEXTROTATE_90; break; case TEXTROTATE_90: uTextRotate = TEXTROTATE_180; break; case TEXTROTATE_180: uTextRotate = TEXTROTATE_270; break; case TEXTROTATE_270: uTextRotate = TEXTROTATE_0; break; } nRet= L_AnnSetTextRotate(hObject, uTextRotate, 0); if (nRet != SUCCESS) { L_AnnGetType(hObject, &uType); wsprintf(szMsg, TEXT("L_AnnSetTextRotate Error: %d on object type[%d]\n"), nRet, uType); MessageBox(NULL, szMsg, TEXT("Error"), MB_OK); return nRet; } return SUCCESS; }