Function Spellings Class

BannerText

Render a string in big block letters. Similar but incomplete version of the UNIX "banner" command.

Signature (Visual Basic / VBA)

Public Function BannerText( _
      ByVal vPhrase As Variant _
    , Optional ByVal vFillChar As Variant _
    ) As Variant

Code Example

    ? BannerText("HI", "0")
    0   0 00000
    0   0   0
    0   0   0
    00000   0
    0   0   0
    0   0   0
    0   0 00000

Parameters

Parameter Description
vPhrase The phrase which is to be rendered in big block letters. Function returns Null if vPhrase is Null or cannot be fixed up to a String.
vFillChar Character which is used to form each pixel of the block letters. vFillChar defaults to an asterisk character ("*") if it is missing, Null, cannot be fixed up to a String, or is an empty string.

Notes & Version History

Note Function currently converts all lower-case characters to their upper case equivalents.
Note Function currently only supports the characters 0..9 and A..Z.
Note Function cannot currently wrap the lines of text within the result string.