Sets the currently active text index.
The user can only change the setting of the text that is currently active.
- That means that if the user calls the function
BCSetActiveTextIndex(pBarCode, 1) all future calls will be applied to text object #1 until another text object is activated in the same manner.
- Following functions are affected by BCSetActiveTextIndex():
- BCSetDisplayText(), BCSetTextRotation(), BCSetLogFont(), BCSetTextAlignment(), BCSetTextPosition(), BCSetPrintText(), BCSetFontName(), BCSetFontHeight(), BCSetFontColor()
- BCGetDisplayText(), BCGetTextRotation(), BCGetLogFont(), BCGetTextAlignment(), BCGetTextPosition(), BCGetPrintText(), BCGetFontName(), BCGetFontHeight(), BCGetFontColor(), BCGetTextClipping(), BCIsWordWrappingEnabled()
- Note:
- By default the human readable text (index 0) is the active text.
- You can change the position and size of an extra text but not that of the human readable text.
- Parameters:
-
| [in] | pBarCode | Pointer to barcode structure. A value of 0 ... means that the human readable text becomes active (this is the default) >0 ... means that the extra text with given index [1 .. n] becomes active |
| [in] | nIndex | The new active text index. |
- Return values:
-
| ERRCODE | ErrOk (0) in case of success. Non-zero if error occurred |
