Select your printer model
addText
Adds string display setting to the command buffer.
Syntax
(int) addText:(NSString *)data; |
(int) addText:(NSString *)data lang:(int)lang; |
(int) addText:(NSString *)data x:(long)x y:(long)y; |
(int) addText:(NSString *)data x:(long)x y:(long)y lang:(int)lang; |
(int) addText:(NSString *)data x:(long)x y:(long)y lang:(int)lang r:(long)r g:(long)g b:(long)b; |
Parameter
data
Specifies the string to display.
lang
Specifies the language to display the string.
Value |
Description |
---|---|
EPOS2_LANG_EN (default) |
English |
EPOS2_LANG_JA |
Japanese |
EPOS2_LANG_MULTI |
Multiple languages (UTF-8) |
EPOS2_PARAM_DEFAULT |
Specifies the default value (English). |
EPOS2_PARAM_UNUSE |
Not used. |
x
Specifies the x coordinate of the display position.
Value |
Description |
---|---|
Integer from 1 to 44 |
X coordinate of the display position |
EPOS2_PARAM_UNUSE |
Not used. |
y
Specifies the y coordinate of the display position.
Value |
Description |
---|---|
Integer from 1 to 19 |
Y coordinate of the display position |
EPOS2_PARAM_UNUSE |
Not used. |
r
Specifies the red color value of the string to be displayed.
Value |
Description |
---|---|
Integer from 0 to 255 |
Red color value |
EPOS2_PARAM_UNUSE |
Not used. |
g
Specifies the green color value of the string to be displayed.
Value |
Description |
---|---|
Integer from 0 to 255 |
Green color value |
EPOS2_PARAM_UNUSE |
Not used. |
b
Specifies the blue color value of the string to be displayed.
Value |
Description |
---|---|
Integer from 0 to 255 |
Blue color value |
EPOS2_PARAM_UNUSE |
Not used. |
Return value
Error status |
Description |
---|---|
EPOS2_SUCCESS |
The function was executed successfully. |
EPOS2_ERR_PARAM |
An invalid parameter was passed. |
EPOS2_ERR_MEMORY |
Necessary memory could not be allocated. |
EPOS2_ERR_FAILURE |
An unknown error occurred. |
Supplementary explanation
- If the coordinates of the display position are omitted, the coordinates of the cursor position upon execution of addText are used.
- Parameters x and y specify coordinates with the origin at the top left of the line display.
- The value that can be specified in the x, y parameters varies depending on the customer display used and its display modes, as well as the installation method.
-
x
y
DM-D30
Integer from 1 to 20
Integer from 1 to 2
DM-D110
DM-D210
DM-D70 (Column/row fixed mode)
DM-D70 (Standard mode: Landscape orientation)
Integer from 1 to 44
Integer from 1 to 13
DM-D70 (Standard mode: Portrait orientation)
Integer from 1 to 22
Integer from 1 to 19
- Specify the setting value in both x and y parameters.
If only a single parameter is specified, EPOS2_SUCCESS is returned, but nothing is displayed. - Specify the r, g, b parameters in the RGB565 format.
- When changing the color of the string to be displayed, specify the setting value in all of the r, g, and b parameters.
- If the setting value is specified in all of the r, g, and b parameters, the font color changes from the position coordinates specified in the x, y parameters.
- If EPOS2_LANG_MULTI is specified in the lang parameter, the font color returns to
the default setting of the customer display.
If the r, g, b parameters are specified after specifying EPOS2_LANG_MULTI in the lang parameter, then r, g, and b are processed after lang, and therefore, the font color specified in r, g, b is applied.
Quick Access
- [Name]
- [Format]
- [Range]
- [Description]
- [Notes]
- Introduction
- help
- Epos2Printer class
- initWithPrinterSeries
- connect
- disconnect
- startMonitor
- stopMonitor
- getStatus
- sendData
- beginTransaction
- endTransaction
- requestPrintJobStatus
- clearCommandBuffer
- addTextAlign
- addLineSpace
- addTextRotate
- addText
- addTextLang
- addTextFont
- addTextSmooth
- addTextSize
- addTextStyle
- addHPosition
- addFeedUnit
- addFeedLine
- addImage
- addLogo
- addBarcode
- addSymbol
- addHLine
- addVLineBegin
- addVLineEnd
- addPageBegin
- addPageEnd
- addPageArea
- addPageDirection
- addPagePosition
- addPageLine
- addPageRectangle
- addRotateBegin
- addRotateEnd
- addCut
- addPulse
- addSound
- addFeedPosition
- addLayout
- addCommand
- getMaintenanceCounter
- resetMaintenanceCounter
- getPrinterSetting
- setPrinterSetting
- getPrinterSettingEx
- setPrinterSettingEx
- setPrinterSettingEx[Obsolete]
- verifyPassword
- getPrinterInformation
- downloadFirmwareList
- getPrinterFirmwareInfo
- verifyUpdate
- updateFirmware
- forceRecover
- forcePulse
- forceStopSound
- forceCommand
- forceReset
- setStatusChangeEventDelegate
- setReceiveEventDelegate
- setGetPrinterSettingExDelegate
- setSetPrinterSettingExDelegate
- setVerifyPasswordDelegate
- interval
- Epos2LFCPrinter class
- Epos2HybridPrinter class
- initWithLang
- connect
- disconnect
- startMonitor
- stopMonitor
- getStatus
- sendData
- beginTransaction
- endTransaction
- clearCommandBuffer
- selectPaperType
- waitInsertion
- cancelInsertion
- ejectPaper
- readMicrData
- cleanMicrReader
- forceRecover
- forcePulse
- forceCommand
- forceReset
- paperType
- interval
- waitTime
- mode40Cpl
- setStatusChangeEventDelegate
- setReceiveEventDelegate
- Epos2LineDisplay class
- initWithDisplayModel
- connect
- disconnect
- getStatus
- sendData
- clearCommandBuffer
- addInitialize
- addCreateWindow
- addDestroyWindow
- addSetCurrentWindow
- addClearCurrentWindow
- addCreateScreen
- addCreateScreenCustom
- addCreateTextArea
- addDestroyTextArea
- addSetCurrentTextArea
- addClearCurrentTextArea
- addSetCursorPosition
- addMoveCursorPosition
- addSetCursorType
- addText
- addReverseText
- addMarqueeText
- addSetBlink
- addSetBrightness
- addBackgroundColor
- addStartSlideShow
- addStopSlideShow
- addDownloadImage
- addRegisterDownloadImage
- addNVImage
- addClearImage
- addSymbol
- addClearSymbol
- addShowClock
- addCommand
- setReceiveEventDelegate
- Epos2Keyboard class
- Epos2POSKeyboard class
- Epos2BarcodeScanner class
- Epos2MSR class
- Epos2SimpleSerial class
- Epos2GermanyFiscalElement class
- Epos2OtherPeripheral class
- Epos2CommBox class
- Common to all classes
- Epos2Discovery class
- Epos2Log class
- Epos2BluetoothConnection class
- EasySelect class
- EasySelectInfo class
- Appendix
- Status list
- Key code list
- List of Supported Classes
- List of Supported APIs
- Printer-specific Support Information
- TM-m10
- TM-m30
- TM-m30II
- TM-m30II-H
- TM-m30II-NT
- TM-m30II-S
- TM-m30II-SL
- TM-m30III
- TM-m30III-H
- TM-m50
- TM-m50II
- TM-m50II-H
- TM-T20
- TM-T20II
- TM-T20III
- TM-T20IIIL
- TM-T20IV-L
- TM-T20X
- TM-T20X-II
- TM-T60
- TM-T70
- TM-T70II
- TM-T81II
- TM-T81III
- TM-T82
- TM-T82II
- TM-T82III
- TM-T82IIIL
- TM-T82IV-L
- TM-T82X
- TM-T82X-II
- TM-T83III
- TM-T83IV
- TM-T88V
- TM-T88VI
- TM-T88VII
- TM-T100
- TM-L90 Liner-Free Label Printer Model
- TM-L100
- TM-U220
- TM-U330
- TM-P20
- TM-P20II
- TM-P60 (Receipt)
- TM-P60 (Peeler)
- TM-P60II (Receipt)
- TM-P60II (Peeler)
- TM-P80
- TM-P80II
- TM-H6000V
- TM-T20II-i
- TM-T70-i
- TM-T82II-i
- TM-T83II-i
- TM-T88V-i
- TM-T88VI-iHUB
- TM-U220-i
- TM-T70II-DT
- TM-T70II-DT2
- TM-T88V-DT
- TM-T88VI-DT2
- TM-H6000IV-DT
- TM-T88IV
- TM-T90
- TM-L90
- TM-H6000IV
- Usage restriction by firmware version