<title>Mask Edit Text View | ENiGMA½ BBS Software</title>
<metaname="generator"content="Jekyll v4.2.1"/>
<metaproperty="og:title"content="Mask Edit Text View"/>
<metaproperty="og:locale"content="en_US"/>
<metaname="description"content="Mask Edit Text View A mask edit text view supports editing form values on a screen. This can be for new entry as well as editing existing values. Unlike a edit text view, the mask edit text view uses a mask pattern to specify what format the values should be entered in."/>
<metaproperty="og:description"content="Mask Edit Text View A mask edit text view supports editing form values on a screen. This can be for new entry as well as editing existing values. Unlike a edit text view, the mask edit text view uses a mask pattern to specify what format the values should be entered in."/>
{"datePublished":"2022-10-01T18:21:19+00:00","description":"Mask Edit Text View A mask edit text view supports editing form values on a screen. This can be for new entry as well as editing existing values. Unlike a edit text view, the mask edit text view uses a mask pattern to specify what format the values should be entered in.","mainEntityOfPage":{"@type":"WebPage","@id":"/enigma-bbs/art/views/mask_edit_text_view.html"},"url":"/enigma-bbs/art/views/mask_edit_text_view.html","@type":"BlogPosting","publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"/enigma-bbs/assets/images/enigma-logo.png"}},"headline":"Mask Edit Text View","dateModified":"2022-10-01T18:21:19+00:00","@context":"https://schema.org"}</script>
<aclass="btn"style="float:left;margin-right: 20px;"href="/enigma-bbs/art/views/horizontal_menu_view.html">« Horizontal Menu View</a>
<ahref="#sidebar"class="btn menu_button">MENU</a>
<aclass="btn"style="float: right;margin-left: 20px"href="/enigma-bbs/art/views/multi_line_edit_text_view.html">Multi Line Edit Text View »</a>
<brclear="both">
</div>
<divclass="page">
<h1class="page-title">Mask Edit Text View</h1>
<h2id="mask-edit-text-view">Mask Edit Text View</h2>
<p>A mask edit text view supports editing form values on a screen. This can be for new entry as well as editing existing values. Unlike a edit text view, the mask edit text view uses a mask pattern to specify what format the values should be entered in.</p>
<p><imgclass="emoji"title=":information_source:"alt=":information_source:"src="https://github.githubassets.com/images/icons/emoji/unicode/2139.png"height="20"width="20"> A mask edit text view is defined with a percent (%) and the characters ME, followed by the view number. For example: <codeclass="language-plaintext highlighter-rouge">%ME1</code>. This is generally used on a form in order to allow a user to enter or edit a text value.</p>
<p><imgclass="emoji"title=":information_source:"alt=":information_source:"src="https://github.githubassets.com/images/icons/emoji/unicode/2139.png"height="20"width="20"> See <ahref="/enigma-bbs/art/mci.html">MCI</a> for general information on how to use views and common configuration properties available for them.</p>
<td>Specifies a character to fill extra space in the text entry with. Defaults to an empty space</td>
</tr>
</tbody>
</table>
<h3id="mask-pattern">Mask Pattern</h3>
<p>A <codeclass="language-plaintext highlighter-rouge">maskPattern</code> must be set on a mask edit text view (not doing so will cause the view to be focusable, but no text can be input). The <codeclass="language-plaintext highlighter-rouge">maskPattern</code> is a set of characters used to define input, as well as optional literal characters that can be entered into the pattern that will always be entered into the input. The following mask characters are supported:</p>
<table>
<thead>
<tr>
<th>Mask Character</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>#</td>
<td>Numeric input, one of 0 through 9</td>
</tr>
<tr>
<td>A</td>
<td>Alphabetic, one of a through z or A through Z</td>
</tr>
<tr>
<td>@</td>
<td>Alphanumeric, matches one of either Numeric or Alphabetic above</td>
</tr>
<tr>
<td>&</td>
<td>Printable, matches one printable character including spaces</td>
</tr>
</tbody>
</table>
<p>Any value other than the entries above is treated like a literal value to be displayed in the patter. Multiple pattern characters are combined for longer inputs. Some examples could include:</p>
