Properties

Mode Current view mode.
Possible values:
  • vbmodeText: Text mode
  • vbmodeBinary: Binary mode
  • vbmodeHex: Hex mode
  • vbmodeUnicode: Unicode mode
  • vbmodeUHex: Combined Unicode/Hex mode
TextEncoding Current text encoding.
Used in non-Unicode modes.
Possible values:
  • vencANSI: ANSI (locale dependent)
  • vencOEM: OEM (locale dependent)
  • vencEBCDIC: IBM EBCDIC US
  • vencKOI8: KOI8-R
  • vencISO: ISO (locale dependent)
  • vencMac: Mac (locale dependent)
  • plus many others, see the complete list in ATxCodepages.pas.
Notes:
  • When encoding is OEM, text may be drawn using different font, see FontOEM.
  • Technical notes:
    • ANSI, OEM, EBCDIC, KOI8, ISO, Mac encodings are always available.
    • EBCDIC, KOI8, ISO, Mac encodings are used via MultiByteToWideChar API, if possible. But if they are not installed on OS (for example, on Win9x), then the hardcoded codepages are used.
    • All other encodings are used via MultiByteToWideChar API, they are available only when installed on OS.
TextEncodingName (public, read-only) Name of current text encoding.
Note:
  • It can be read in all modes, even in Unicode. In Unicode modes is will show "UTF-16 LE" or "UTF-16 BE".
TextWrap Enables word wrap.
Works in Text and Unicode modes.
TextWidth
TextWidthHex
TextWidthUHex 		Width of text in fixed-length modes:
  • TextWidth: Binary mode.
  • TextWidthHex: Hex mode.
  • TextWidthUHex: Unicode/Hex mode.
TextWidthFit
TextWidthFitHex
TextWidthFitUHex 		Enables width auto-fit in fixed-length modes.
  • TextWidthFit: Binary mode.
  • TextWidthFitHex: Hex mode.
  • TextWidthFitUHex: Unicode/Hex mode.
Note:
  • These properties work correctly only with monospaced fonts. With fonts of variable width you can get text partially not fitting in the control.
TextSearchIndentVert
TextSearchIndentHorz 		Text indents, used when text is highlighted with successfull FindText / FindNext methods call.
  • TextSearchIndentVert: number of lines above selection.
  • TextSearchIndentHorz: average number of chars lefter than selection.
TextTabSize Tabulation (#9) size.
TextOemSpecial Enables usage of special OEM font (when TextEncoding = vencOEM).
Note:
  • This property should be set to True only on older Win9x systems. NT systems support displaying of OEM text in Unicode (using MultiByteToWideChar API and Unicode fonts), so special OEM font is not needed.
TextGutter
TextGutterLines
TextGutterLinesBufSize
TextGutterLinesCount
TextGutterLinesStep
TextGutterLinesExtUse
TextGutterLinesExtList 		Gutter (vertical bar on the left) options:
  • Enables gutter.
  • Enables line numbers on gutter (in var length modes).
  • Buffer size for line numbers. Lines below this buffer are not counted. Recommended is ~300Kb .. 1Mb.
  • Maximal count of line numbers shown.
  • Step for line numbers. Minimal is 1, means "show numbers for all lines".
  • Enables lines numbers only for specified file extensions.
  • List of file extensions for the previous option. It can be, for example, 'c,cpp,h,hpp,pas,dpr'.
TextUrlHilight Enables URL/mail highlighting.
On URL clicking the OnClickURL event occurs.
Note:
  • For this option to work the RegEx library must be compiled in. See ATBinHexOptions.inc file: "REGEX" and "SEARCH" defines must be enabled.
TextNonPrintable Enables displaying of non-printable characters.
Note:
  • When enabled, spaces are shown as small dots, tabs (#9) are shown as "right arrows", and line ends are shown as "paragraphs".
Font (inherited)
FontOEM
FontFooter
FontGutter 		Fonts:
  • Default font.
  • OEM text font. Used in Text/Binary/Hex modes when (TextEncoding = vEncOEM) and (TextOemSpecial = True).
  • Font for printing footer.
  • Font for gutter line numbers.
Color (inherited)
TextColorGutter
TextColorURL
TextColorHi
TextColorHex
TextColorHex2
TextColorHexBack
TextColorLines
TextColorError 		Colors of:
  • Text background
  • Gutter
  • URLs
  • Search highlight color (for option asoShowAll)
  • Hex digits (even)
  • Hex digits (odd)
  • Hex digits background
  • Hex mode vertical lines
  • Error messages (displayed when read error occurs)
AutoReload
AutoReloadBeep
AutoReloadFollowTail
AutoReloadSimple
AutoReloadSimpleTime 		File auto-reloading options:
  • Enables auto-reload.
  • Enables beep on reload.
  • Enables repositioning at the file end, if previous view position was also at the end.
  • Sets "simple" notification mode. In this mode file is just checked by timer, no FindFirstChangeNotification API is used. This is recommended for network files (API doesn't work for this case).
  • Timer interval for "simple" notification mode, default is 1000 msec.
TextPopupCommands Set of commands visible in the popup (right-click) menu.
Commands available:
  • vpCmdCopy: Copy selection to Clipboard.
  • vpCmdCopyHex: Copy selection in hex form in Hex mode.
  • vpCmdSelectLine: Select current line.
  • vpCmdSelectAll: Select all text.
  • vpCmdEncMenu: Show encodings menu.
TextPopupCaption[AIndex: TATPopupCommand]
(public, write-only) 		Captions of popup (right-click) menu items.
For possible values of AIndex see TextPopupCommands.
MaxLengths[AIndex: TATBinHexMode] (public) Maximal line lengths.
These values are for all view modes of ATBinHex control: Text, Binary, Hex, Unicode. They set internal values that define the maximal length of a single string in a file. Values are 300 by default. For example, you may set MaxLengths[vbmodeText] to 1000 if user needs to work with strings of length 1000 in Text mode.
Notes:
  • Larger values increase size of memory buffer for a file, and slow down file reading.
  • Values are applied after file reopening, e.g. after calling Open/OpenStream/Reload methods and after changing Mode property.
MaxClipboardDataSizeMb (public) Maximal data size (in Mb) for copying to Clipboard.
Default value is 16 (Mb), which prevents visual "hanging" when too large block is selected accidentally before copying.
SelStart (public)
SelLength (public)
SelText (public, read-only)
SelTextW (public, read-only)
SelTextShort (public, read-only)
SelTextShortW (public, read-only) 		Current selection properties:
  • SelStart: Selection start (Int64, 0-based).
  • SelLength: Selection length (Int64).
  • SelText: Selection text (AnsiString) in non-Unicode modes.
  • SelTextW: Selection text (WideString) in Unicode mode.
  • SelTextShort: Same as SelText, but limited to the length of 256 chars.
  • SelTextShortW: Same as SelTextW, but limited to the length of 256 chars.
Note:
  • You should call SelText/SelTextW inside try...except block, because when selection is too big, exception is generated.
PosPercent
PosOffset
PosLine (public) 		Current scroll position:
  • Relative position in percents (%).
  • Absolute offset (Int64, 0-based).
  • Line number (1-based, 0 if line number is not found).
Notes for line numbers:
  • Lines are separated by: #13#10, #13, #10.
  • Line numbers are counted only for the first portion of file (see TextGutterLines*).
  • Line numbers are counted for the "current" copy of file, they may be incorrect if file was changed (and not reloaded) since the last display.
SearchResultStart
SearchResultLength
SearchStarted
SearchString (public, read-only) 		Search-related:
  • Search match position (Int64, 0-based). Negative if search was failed.
  • Search match length.
  • Property which shows was search started after the last file reload or not. It is set to False on each file realod.
  • Last search string used.
MarginLeft
MarginTop
MarginRight
MarginBottom (public) 		Printing margins.
Currently in mm.
TextLineSpacing Interline spacing in pixels (default is 0).
TextEnableSel Enables selection.
If set to False, text cannot be selected by user.