<title>Full Menu View | ENiGMA½ BBS Software</title>
<metaname="generator"content="Jekyll v4.2.1"/>
<metaproperty="og:title"content="Full Menu View"/>
<metaproperty="og:locale"content="en_US"/>
<metaname="description"content="Full Menu View A full menu view supports displaying a list of times on a screen in a very configurable manner. A full menu view supports either a single row or column of values, similar to Horizontal Menu (HM) and Vertical Menu (VM), or in multiple columns."/>
<metaproperty="og:description"content="Full Menu View A full menu view supports displaying a list of times on a screen in a very configurable manner. A full menu view supports either a single row or column of values, similar to Horizontal Menu (HM) and Vertical Menu (VM), or in multiple columns."/>
{"description":"Full Menu View A full menu view supports displaying a list of times on a screen in a very configurable manner. A full menu view supports either a single row or column of values, similar to Horizontal Menu (HM) and Vertical Menu (VM), or in multiple columns.","headline":"Full Menu View","url":"/enigma-bbs/art/views/full_menu_view.html","dateModified":"2023-05-11T18:07:54+00:00","@type":"BlogPosting","datePublished":"2023-05-11T18:07:54+00:00","mainEntityOfPage":{"@type":"WebPage","@id":"/enigma-bbs/art/views/full_menu_view.html"},"publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"/enigma-bbs/assets/images/enigma-logo.png"}},"@context":"https://schema.org"}</script>
<aclass="btn"style="float:left;margin-right: 20px;"href="/enigma-bbs/art/views/edit_text_view.html">« Edit Text View</a>
<ahref="#sidebar"class="btn menu_button">MENU</a>
<aclass="btn"style="float: right;margin-left: 20px"href="/enigma-bbs/art/views/horizontal_menu_view.html">Horizontal Menu View »</a>
<brclear="both">
</div>
<divclass="page">
<h1class="page-title">Full Menu View</h1>
<h2id="full-menu-view">Full Menu View</h2>
<p>A full menu view supports displaying a list of times on a screen in a very configurable manner. A full menu view supports either a single row or column of values, similar to Horizontal Menu (HM) and Vertical Menu (VM), or in multiple columns.</p>
<p>Items can be selected on a menu via the cursor keys, Page Up, Page Down, Home, and End, or by selecting them via a <codeclass="language-plaintext highlighter-rouge">hotKey</code> - see <strong><em>Hot Keys</em></strong> below.</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 full menu view is defined with a percent (%) and the characters FM, followed by the view number. For example: <codeclass="language-plaintext highlighter-rouge">%FM1</code></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>If set to <codeclass="language-plaintext highlighter-rouge">true</code> any <codeclass="language-plaintext highlighter-rouge">accept</code> action upon this view will submit the encompassing <strong>form</strong>
<td>If a single column cannot be displayed due to <codeclass="language-plaintext highlighter-rouge">width</code>, set overflow characters. See <strong>Text Overflow</strong> below</td>
<td>Sets the format for a focused list entry. See <strong>Entry Formatting</strong> in <ahref="/enigma-bbs/art/mci.html">MCI</a>
</td>
</tr>
</tbody>
</table>
<h3id="hot-keys">Hot Keys</h3>
<p>A set of <codeclass="language-plaintext highlighter-rouge">hotKeys</code> are used to allow the user to press a character on the keyboard to select that item, and optionally submit the form.</p>
<p>This would select and submit the first item if <codeclass="language-plaintext highlighter-rouge">A</code> is typed, second if <codeclass="language-plaintext highlighter-rouge">B</code>, etc.</p>
<h3id="items">Items</h3>
<p>A full menu, similar to other menus, take a list of items to display in the menu. For example:</p>
<p>If the list is for display only (there is no form action associated with it) you can omit the data element, and include the items as a simple list:</p>
<p>The <codeclass="language-plaintext highlighter-rouge">textOverflow</code> option is used to specify what happens when a text string is too long to fit in the <codeclass="language-plaintext highlighter-rouge">width</code> defined. Note, because columns are automatically calculated, this can only occur when the text is too long to fit the <codeclass="language-plaintext highlighter-rouge">width</code> using a single column.</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"> If <codeclass="language-plaintext highlighter-rouge">textOverflow</code> is not specified at all, a menu can become wider than the <codeclass="language-plaintext highlighter-rouge">width</code> if needed to display a single column.</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"> Setting <codeclass="language-plaintext highlighter-rouge">textOverflow</code> to an empty string <codeclass="language-plaintext highlighter-rouge">textOverflow: ""</code> will cause the item to be truncated if necessary without any characters displayed</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"> Otherwise, setting <codeclass="language-plaintext highlighter-rouge">textOverflow</code> to one or more characters will truncate the value if necessary and display those characters at the end. i.e. <codeclass="language-plaintext highlighter-rouge">textOverflow: ...</code></p>