{"id":1420,"date":"2008-02-29T03:45:26","date_gmt":"2008-02-29T09:45:26","guid":{"rendered":"http:\/\/www.mrc-productivity.com\/docs\/?page_id=1420"},"modified":"2024-07-12T16:11:01","modified_gmt":"2024-07-12T21:11:01","slug":"m-painter-manual","status":"publish","type":"ht_kb","link":"https:\/\/www.mrc-productivity.com\/docs\/knowledge-base\/m-painter-manual","title":{"rendered":"m-Painter Manual"},"content":{"rendered":"\n<p class=\"wp-block-ht-blocks-messages wp-block-hb-message wp-block-hb-message--withicon is-style-info\"><em>Click <a href=\"https:\/\/www.mrc-productivity.com\/legacy\/m-painter-app-prop\/m-painter-manual\">here <\/a>to view the legacy documentation of this feature.<\/em><\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Introduction<\/h2>\n\n\n\n<p>m-Painter is an integral part of the m-Power platform as it allows you to customize your generated content in a user-friendly, easy to use point and click interface. <\/p>\n\n\n\n<p>The goal of this document is to present the m-Power developer with all available options within m-Painter.<\/p>\n\n\n\n<p class=\"wp-block-ht-blocks-messages wp-block-hb-message wp-block-hb-message--withicon is-style-info\">This version of m-Painter is designed to work with Bootstrap templates only. In the event you are using non-Bootstrap templates, or applications built prior to January 1, 2024, please utilize the legacy documentation link referenced above.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Top Panel<\/h2>\n\n\n\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" src=\"\/docs\/images\/paintertop1.png\" alt=\"\"\/><\/figure>\n\n\n\n<p>The top panel allows you to do a variety of options to your application, including saving, running, and setting various editing modes.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Save<\/h3>\n\n\n\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" src=\"\/docs\/images\/paintersave.png\" alt=\"\"\/><\/figure>\n\n\n\n<p>Clicking this button will save any changes made to all HTML files associated with this application. Be sure to click this button prior to navigating away from m-Painter. You can also press CTRL + S to save.<\/p>\n\n\n\n<p>In the event that someone else, or even you, may have edited this application and saved a version more recently, expect to see an error message like this appear: <\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" src=\"\/docs\/images\/painterconfirm.png\" alt=\"\"\/><\/figure>\n\n\n\n<p>Choosing <strong>Cancel <\/strong>will ignore your save request.<\/p>\n\n\n\n<p><strong>View Newest<\/strong> will allow pop-up a modal window for you to see what the latest changes are.<\/p>\n\n\n\n<p><strong>Overwrite<\/strong> will replace the current version with your version.<\/p>\n\n\n\n<p><strong>Reload<\/strong> will reload your m-Painter, causing you to lose all of your changes and refreshing the most recent version for you to edit. <\/p>\n\n\n\n<h4 class=\"wp-block-heading\">Open File<\/h4>\n\n\n\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" src=\"\/docs\/images\/painteropenfile.png\" alt=\"\"\/><\/figure>\n\n\n\n<p>Choosing the pulldown menu within the Save button allows you to choose Open File. You can also press CTRL + O to open this dialog.<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" src=\"\/docs\/images\/painteropenfiledialog.png\" alt=\"\"\/><\/figure>\n\n\n\n<p>From here you can choose to open one of the following file types:<\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Primary HTML Files \u2013 these are the main HTML file(s) that m-Power expects a standard application to utilize.<\/li>\n\n\n\n<li>Custom HTML Files \u2013 Any specific HTML files you save (via Save as) would appear here. Use cases of this option are the use of multiple HTML files as <a href=\"https:\/\/www.mrc-productivity.com\/docs\/knowledge-base\/how-to-use-page-name-to-show-different-outputs-for-one-application\" target=\"_blank\" rel=\"noreferrer noopener\">pageNames <\/a>for an application.<\/li>\n\n\n\n<li>Other Files \u2013 All other files related to this app can be found here, including the property file, the JSON spec file, and the java source file. Most users would have no need working with these files.<\/li>\n<\/ol>\n\n\n\n<h4 class=\"wp-block-heading\">Versions<\/h4>\n\n\n\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" src=\"\/docs\/images\/painterversions.png\" alt=\"\"\/><\/figure>\n\n\n\n<p>Each and every time you make a save in m-Painter, the software captures a version of this in the event you wish to go back to this change sometime in the future. Files that were auto generated due to an overwritten HTML request, will be appended with \u201cgenerated by m-Power\u201d<\/p>\n\n\n\n<p>Learn more about restoring versions <a href=\"https:\/\/www.mrc-productivity.com\/docs\/knowledge-base\/using-m-painter-versions-to-restore-files\" target=\"_blank\" rel=\"noreferrer noopener\">here<\/a>.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">Save as<\/h4>\n\n\n\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" src=\"\/docs\/images\/paintersaveas.png\" alt=\"\"\/><\/figure>\n\n\n\n<p>In the event you wish to have multiple HTML output files for the same application (i.e. pageName solution), you would utilize the Save As option.<\/p>\n\n\n\n<p>Learn more about pageNames <a href=\"https:\/\/www.mrc-productivity.com\/docs\/knowledge-base\/how-to-use-page-name-to-show-different-outputs-for-one-application\" target=\"_blank\" rel=\"noreferrer noopener\">here<\/a>.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">Save Version as<\/h4>\n\n\n\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" src=\"\/docs\/images\/paintersaveversionas.png\" alt=\"\"\/><\/figure>\n\n\n\n<p>This option is useful if you would like to specifically name this version to reference in the future when using the \u201cVersions\u201d option. Simply type in your note here and it will be appended to the application details on the Versioning menu.<\/p>\n\n\n\n<p>Learn more about this feature <a href=\"https:\/\/www.mrc-productivity.com\/docs\/knowledge-base\/using-m-painter-versions-to-restore-files#save-version-as\" target=\"_blank\" rel=\"noreferrer noopener\">here<\/a>.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Run<\/h3>\n\n\n\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" src=\"\/docs\/images\/painterrun.png\" alt=\"\"\/><\/figure>\n\n\n\n<p>Clicking this button will run your last saved version of this file in a new tab. To return back to m-Painter, simply close the run-time application tab.<\/p>\n\n\n\n<p>You can also press CTRL + E to run this application.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Undo\/Redo<\/h3>\n\n\n\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" src=\"\/docs\/images\/painterundoredo.png\" alt=\"\"\/><\/figure>\n\n\n\n<p>CTRL + Z (undo) and CTRL + Y (Redo) will let you move through any changes you have made that you would like to adjust. Undo\/Redo is only available for current changes. In other words, you cannot undo\/redo changes made during a previous editing session (consider using versioning instead).<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Design\/Source<\/h3>\n\n\n\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" src=\"\/docs\/images\/painterdesignsource.png\" alt=\"\"\/><\/figure>\n\n\n\n<p>Allows you to toggle back and forth between the graphical editor and an HTML editor.<\/p>\n\n\n\n<p>Learn more about Source mode <a href=\"https:\/\/www.mrc-productivity.com\/docs\/knowledge-base\/m-painter-source-mode-features\" target=\"_blank\" rel=\"noreferrer noopener\">here<\/a>.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Drag &amp; Drop<\/h3>\n\n\n\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" src=\"\/docs\/images\/draganddrop.png\" alt=\"\"\/><\/figure>\n\n\n\n<p>If clicked, m-Painter will no longer add, edit, or delete elements. However, you are able to click, drag, and move elements around the page.<\/p>\n\n\n\n<p>Learn more about Drag &amp; Drop functionality <a href=\"https:\/\/www.mrc-productivity.com\/docs\/knowledge-base\/working-with-form-layout-grid-layout\">here<\/a>.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Layout<\/h3>\n\n\n\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" src=\"\/docs\/images\/layout_button.png\" alt=\"\"\/><\/figure>\n\n\n\n<p>When layout is selected, a toggle switch will appear, allowing the user to decide to be in either &#8220;Form Layout&#8221; mode or &#8220;Grid Layout&#8221; mode. In either case, activating the grid option makes the green navigation hover available, allowing you to create, remove, and resize elements on the page. (Click <a href=\"https:\/\/www.mrc-productivity.com\/docs\/knowledge-base\/form-layout\">here <\/a>for more information about the green hover menu).<\/p>\n\n\n\n<p>Generally speaking, the Form Layout mode is used when wanting to drag and drop to rearrange inputs on a form. Grid Layout mode, on the other hand, is generally used for wanting to adjust the layout of elements <em>outside<\/em> the form, such as splitting an area of the screen in half to allow space for new elements on the page.<\/p>\n\n\n\n<p>Learn more about Grid functionality <a href=\"https:\/\/www.mrc-productivity.com\/docs\/knowledge-base\/grid-layout\">here<\/a>.<\/p>\n\n\n\n<p>Learn more about Grid Layout vs Form Layout <a href=\"https:\/\/www.mrc-productivity.com\/docs\/knowledge-base\/working-with-form-layout-grid-layout\">here<\/a>.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Mobile \/ PC View<\/h3>\n\n\n\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" src=\"\/docs\/images\/painterview.png\" alt=\"\"\/><\/figure>\n\n\n\n<p>Allows you to toggle back and forth to see how your application would render on a PC or mobile device at runtime.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Return to Application<\/h3>\n\n\n\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" src=\"\/docs\/images\/painterreturn.png\" alt=\"\"\/><\/figure>\n\n\n\n<p>Use this button to return to the specifications of this application. If you have any unsaved changes, m-Painter will prompt you to save before allowing you to navigate away.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Main Page\/Web Form\/Responsive Detail Tab<\/h3>\n\n\n\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" src=\"\/docs\/images\/painterpages.png\" alt=\"\"\/><\/figure>\n\n\n\n<p>Depending on your template type, you will see slightly different options here. This option allows you to effortlessly move between editing the different primary HTML files available to your application. You do not need to save changes made in between navigating these files.<\/p>\n\n\n\n<p>If there is an asterisk (*) after the file name, it means that file has been changed but has not yet been saved (see above for example).<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Page Options<\/h3>\n\n\n\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" src=\"\/docs\/images\/painterpageoptions.png\" alt=\"\"\/><\/figure>\n\n\n\n<p>Clicking this button brings open a sub-menu allowing you to remove HTML and revert your application back to various levels of code. Including:<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">Replace with Original<\/h4>\n\n\n\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" src=\"\/docs\/images\/painterreplace.png\" alt=\"\"\/><\/figure>\n\n\n\n<p>As the name suggests, this option will revert your HTML to the latest stock version available. In other words, all custom HTML changes will be removed and the latest fresh version of HTML that has been compiled will be used instead.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">Clear page contents<\/h4>\n\n\n\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" src=\"\/docs\/images\/painterclear.png\" alt=\"\"\/><\/figure>\n\n\n\n<p>This option allows developers to remove most of the HTML\u2019s code, leaving only the basic HTML structure. This is helpful in the event you wanted to heavily customize your application and discard the built-in functionality.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Filters<\/h3>\n\n\n\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" src=\"\/docs\/images\/painterfilters.png\" alt=\"\"\/><\/figure>\n\n\n\n<p>If your application has a \u201cFilters\u201d area, clicking this checkbox will toggle it on and off within m-Painter.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Element Panel<\/h2>\n\n\n\n<p>The element panel, available on the right side of m-Painter, is a dynamic area that allows you to work with whichever element you have selected within the main editing panel. Depending on which element you have selected, different element options will be available for use.<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" src=\"\/docs\/images\/painterelementpanel.png\" alt=\"\"\/><\/figure>\n\n\n\n<p class=\"wp-block-ht-blocks-messages wp-block-hb-message wp-block-hb-message--withicon is-style-info\">If you wish to minimize the Element Panel, simply click on the &#8216;X&#8217; next to &#8220;Configure Selected Element.&#8221; Doing so will cause the Element Panel to only be maximized when your cursor if hovering over it.<\/p>\n\n\n\n<h3 class=\"wp-block-heading has-large-font-size\">Element Options<\/h3>\n\n\n\n<p>The options on display in this section depend on what element you have selected in the main panel. You\u2019ll note the label below \u201cElement Options\u201d indicates what HTML element is currently selected. Different elements have different options available.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">Input Options<\/h4>\n\n\n\n<h5 class=\"wp-block-heading\"><strong>Convert Input to<\/strong>\u2026<\/h5>\n\n\n\n<p>Useful to convert a basic input box into something more user friendly for your end-user. No matter which option you pick you will first need to select <em>where<\/em> the data will be coming from. Available options include:<\/p>\n\n\n\n<p><strong>Data Model &#8212;<\/strong> If you choose a data model, be sure to indicate within the Field settings which field will be the list value and which will be the list description.<\/p>\n\n\n\n<p><strong>m-Power Application &#8212;<\/strong> If you choose, m-Power application, you will be able to select a retrieval as a data source, so long as it was built as a Option List template.<\/p>\n\n\n\n<p><strong>Query Current App &#8212;<\/strong> If chosen, allows you to query the current application to determine a distinct list. This option is disallowed in maintainers. It is also encouraged to not use this approach if you have a particularly large data set, as the performance of the dropdown decreases as the amount of data increases.<\/p>\n\n\n\n<p><strong>Quicklists &#8212;<\/strong> Best designed for simple options where data is unlikely to change and building an external dropdown list would be excessive (An example here would be the options Yes and No).<\/p>\n\n\n\n<p>Learn more about Quick Lists <a href=\"https:\/\/www.mrc-productivity.com\/docs\/knowledge-base\/quick-lists\" target=\"_blank\" rel=\"noreferrer noopener\">here<\/a>.<\/p>\n\n\n\n<p class=\"has-medium-font-size\"><strong>Can convert to the following Input Types:<\/strong><\/p>\n\n\n\n<p><strong>Dropdown list<\/strong> &#8212; Creates a basic dropdown list. If you want to force the user to select a value, remove the \u201cSelect a value\u201d text from the Blank option text option.<\/p>\n\n\n\n<p><strong>Radio Buttons &#8211;<\/strong>&#8211; Similar to a dropdown box in that only one value can be chosen. The difference is that all options are shown on the screen. <\/p>\n\n\n\n<p><strong>Checkboxes &#8212; <\/strong>Allows multiple values to be checked per field.<\/p>\n\n\n\n<p><strong>Comboboxes &#8211;<\/strong> Allows user to be able to type ahead to enter a given value.<\/p>\n\n\n\n<p><strong>Textarea &#8212;<\/strong> This allows your user to see and enter much more data than one what would traditionally be allowed in an input box.<\/p>\n\n\n\n<p>Learn more about Option Lists <a href=\"https:\/\/www.mrc-productivity.com\/docs\/knowledge-base\/create-dropdowns-in-m-painter\" target=\"_blank\" rel=\"noreferrer noopener\">here<\/a>.<\/p>\n\n\n\n<h5 class=\"wp-block-heading\">Calendar Picker<\/h5>\n\n\n\n<p>Useful when working with dates. Be sure to specify the proper date format for your needs. The Max days in the past\/future restrict what the user can select from the calendar picker.<\/p>\n\n\n\n<p>Click <a href=\"https:\/\/www.mrc-productivity.com\/docs\/knowledge-base\/create-calendar-helper-in-m-painter\" target=\"_blank\" rel=\"noreferrer noopener\">here<\/a> to learn more about Calendar Pickers.<\/p>\n\n\n\n<h5 class=\"wp-block-heading\">Input Properties<\/h5>\n\n\n\n<p>Available only for input boxes, allows you to modify a variety of options about this specific input box. If you are looking to enable signature capture, click the \u201cSignature\u201d box at the bottom of the screen to convert this input to accept Signature capture.<\/p>\n\n\n\n<p>Learn more about input properties <a href=\"https:\/\/www.mrc-productivity.com\/docs\/knowledge-base\/text-field-properties\" target=\"_blank\" rel=\"noreferrer noopener\">here<\/a>.<\/p>\n\n\n\n<p>Learn more about signature capture <a href=\"https:\/\/www.mrc-productivity.com\/docs\/knowledge-base\/signature-capture-in-m-power-maintainers\" target=\"_blank\" rel=\"noreferrer noopener\">here<\/a>.<\/p>\n\n\n\n<h5 class=\"wp-block-heading\">Edit Option List<\/h5>\n\n\n\n<p>Only available if you have selected an option list. Allows you to modify your option list.<\/p>\n\n\n\n<h5 class=\"wp-block-heading\">Ajax Input Helpers<\/h5>\n\n\n\n<p>Three AJAX options allow your user to interact with the server without having to refresh the page: Type-Ahead Suggestion, Cascading Dropdown List, Return Data to Input.<\/p>\n\n\n\n<p>Learn more about AJAX Helpers <a href=\"https:\/\/www.mrc-productivity.com\/docs\/knowledge-base\/using-ajax-helpers\" target=\"_blank\" rel=\"noreferrer noopener\">here<\/a>.<\/p>\n\n\n\n<h5 class=\"wp-block-heading\">Lookup and Return Input Data<\/h5>\n\n\n\n<p>Allows your user to open a separate retrieval in a pop up modal window, and \u201creturn data\u201d from that page to your current form. <\/p>\n\n\n\n<p>Learn more about this feature <a href=\"https:\/\/www.mrc-productivity.com\/docs\/knowledge-base\/create-lookup-window-in-m-painter\" target=\"_blank\" rel=\"noreferrer noopener\">here<\/a>.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">Text\/Field Options<\/h4>\n\n\n\n<h5 class=\"wp-block-heading\">Smartlink<\/h5>\n\n\n\n<p>Utilize this feature to link one application to another, via a hyperlink.<\/p>\n\n\n\n<p>Learn more about Smartlinks <a href=\"https:\/\/www.mrc-productivity.com\/docs\/knowledge-base\/working-with-smartlinks\" target=\"_blank\" rel=\"noreferrer noopener\">here<\/a>.<\/p>\n\n\n\n<h5 class=\"wp-block-heading\">Key\/Value Lookup<\/h5>\n\n\n\n<p>This feature allows you to automatically pass the selected value (the key value) to an external retrieval. Based on the value passed, all fields associated with that row would be available to be returned to your current application.<\/p>\n\n\n\n<p>Learn more about this feature <a href=\"https:\/\/www.mrc-productivity.com\/docs\/knowledge-base\/key-pairs\" target=\"_blank\" rel=\"noreferrer noopener\">here<\/a>.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">General Options<\/h4>\n\n\n\n<h5 class=\"wp-block-heading\">Edit HTML<\/h5>\n\n\n\n<p>In the event you need to work with the HTML, this option will allow you to work with the highlighted HTML element, rather than with the entire source.<\/p>\n\n\n\n<p>Learn more about this feature <a href=\"https:\/\/www.mrc-productivity.com\/docs\/knowledge-base\/element-window-in-m-painter\" target=\"_blank\" rel=\"noreferrer noopener\">here<\/a>.<\/p>\n\n\n\n<h5 class=\"wp-block-heading\">Hide\/Show Element<\/h5>\n\n\n\n<p>Toggles the element between visible and hidden at run-time. <\/p>\n\n\n\n<p class=\"wp-block-ht-blocks-messages wp-block-hb-message wp-block-hb-message--withicon is-style-alert\">The element will always be visible within m-Painter.<\/p>\n\n\n\n<h5 class=\"wp-block-heading\">Replace Element With&#8230;<\/h5>\n\n\n\n<p>Allows you to load a specific element from your original HTML file. Helpful to revert a specific change, or even load in a new feature without having to overwrite your entire HTML.<\/p>\n\n\n\n<p>Click <a href=\"https:\/\/www.mrc-productivity.com\/docs\/knowledge-base\/replace-element-with\">here <\/a>to learn more about this feature.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">Report Options<\/h4>\n\n\n\n<h5 class=\"wp-block-heading\">Toggle Report Level<\/h5>\n\n\n\n<p>Allows you to hide\/show output level(s) at runtime. Useful in the event you want to stop users from toggling a particular report level at runtime.<\/p>\n\n\n\n<h5 class=\"wp-block-heading\">Toggle Selected Report Output<\/h5>\n\n\n\n<p>Allows you to hide\/show specific report outputs. Useful in the event you want to stop users from exporting to Excel or PDF, for example.<\/p>\n\n\n\n<h5 class=\"wp-block-heading\">Output Format<\/h5>\n\n\n\n<p>Useful if you would like to change an output format. Say for instance, you wanted to change the Excel output to CSV.<\/p>\n\n\n\n<h5 class=\"wp-block-heading\">Data Field to Report Level<\/h5>\n\n\n\n<p>Available only when your current element is a field. Allows you to change the location of where your data is coming from (Choose Non-Totaled) if you want m-Power to not total values at the sub-total and grand total levels.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">Table Element Options<\/h4>\n\n\n\n<h5 class=\"wp-block-heading\">Merge Cell Right<\/h5>\n\n\n\n<p>Merges the currently selected cell with the cell directly to the right of it. All content in the merged cell is removed.<\/p>\n\n\n\n<h5 class=\"wp-block-heading\">Merge All Cells<\/h5>\n\n\n\n<p>All cells in the currently selected row are merged. All content, except for that of the highlighted element is removed.<\/p>\n\n\n\n<h5 class=\"wp-block-heading\">+ Column Left<\/h5>\n\n\n\n<p>Adds one column to the left of the selected cell. This will also add the necessary cells for any other applicable row (such as column headings).<\/p>\n\n\n\n<h5 class=\"wp-block-heading\">+ Column Right<\/h5>\n\n\n\n<p>Adds one column to the right of the selected cell. This will also add the necessary cells for any other applicable row.<\/p>\n\n\n\n<h5 class=\"wp-block-heading\">Select Data Table<\/h5>\n\n\n\n<p>Available when any table element is selected, clicking this button will automatically highlight the parent table.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Styling Overrides<\/h3>\n\n\n\n<p>In general, styling elements directly should be your last option. Instead, it is preferred to set your element styles at the dictionary level. The main benefit to this approach is that should you want to repeat certain styling across more than one application, the CSS rules would already be in place. That being said, you are open to add the following element level CSS rules to change how they appear with in the application.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">Class &amp; Style Attributes<\/h4>\n\n\n\n<p>Classes need to be space separated. Styles should use traditional element syntax. For instance width:600px;<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">Margin<\/h4>\n\n\n\n<p>Use the build in margin options, or, if specifying your own, be sure to denote your setting with the proper unit of measure. For instance, 5px. Margin controls how much space is between this element and surrounding elements.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">Padding<\/h4>\n\n\n\n<p>Use the build in padding options, or, if specifying your own, be sure to denote your setting with the proper unit of measure. For instance, 5px. Padding controls how much space is added between the selected element and it\u2019s container\u2019s border.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">Display<\/h4>\n\n\n\n<p>Options include, inline, inline-block, and block.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">Height\/Width<\/h4>\n\n\n\n<p>Be sure to specify a proper unit of measure. For instance 100px.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">Background Color<\/h4>\n\n\n\n<p>Chose one of the preselected colors or click the button on the right to open a color wheel.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">Font<\/h4>\n\n\n\n<p>Specify the font-type, whether it is bolded or not as well as the color.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">Border<\/h4>\n\n\n\n<p>Specify border type, thickness, and color of border around the selected element.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">Border Radius<\/h4>\n\n\n\n<p>Useful if you would like to have rounded corners around an element. For instance, around an input box.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">Align Self (float)<\/h4>\n\n\n\n<p>Control the alignment of the entire selected element.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">Align Text (text-align)<\/h4>\n\n\n\n<p>Control the alignment of the text <em>within <\/em>the selected element.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">Align Children (Flex)<\/h4>\n\n\n\n<p>Control the alignment (vertical and horizontal) of elements within an element.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">Shadow<\/h4>\n\n\n\n<p>Select either small, medium, or large to set the size of the shadow for the selected element.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Conditional Rendering<\/h3>\n\n\n\n<p>The idea of conditional rendering allows you to add logic to your presentation layer without having to resort to a client-side scripting language. <\/p>\n\n\n\n<p>Learn more about conditional rendering <a href=\"https:\/\/www.mrc-productivity.com\/docs\/knowledge-base\/visibility-controls-via-m-painter\">here<\/a>.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">Set Text<\/h4>\n\n\n\n<p>Based on a field value, show text on a page.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">Styling (Color Coding)<\/h4>\n\n\n\n<p>Based on a value set specific styling rules. Often this is used to color code cells based on field values.<\/p>\n\n\n\n<p>Learn more about this feature <a href=\"https:\/\/www.mrc-productivity.com\/docs\/knowledge-base\/color-coding-via-m-painter\">here<\/a>.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">CSS Classes<\/h4>\n\n\n\n<p>Based on a value set a CSS class.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">Remove if\u2026<\/h4>\n\n\n\n<p>On page load, this option checks to see if a value, at page load, exists. If so, the corresponding element will be removed.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">Hide when\u2026 <\/h4>\n\n\n\n<p>On change, this logic will hide the selected element on the page once a user sets a value to a certain value or blank. Often this is used to hide an input element based off of another input\u2019s value.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">Show when\u2026 <\/h4>\n\n\n\n<p>On change, this logic will show the selected element on the page once a user sets a value to a certain value or blank. Often this is used to show an input element based off of another input\u2019s value.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">Toggle on Click<\/h4>\n\n\n\n<p>This feature is used to hide\/show an element when a user clicks on an element (usually a button).<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">Conditional Element<\/h4>\n\n\n\n<p>In the event you wish to add more than one condition to an element, choose this option. For instance, if you wanted to change the background color of the element AND the text, you wouldn&#8217;t be able to do both of those things with the other conditional options but you could do the Conditional Element option and then set those background color and text yourself in m-Painter<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Component Panel<\/h2>\n\n\n\n<p>The component panel can be found on the left side of your m-Painter window. If you would like the left side to always be maximized, click the pin icon. To reduce its size, press the &#8216;X&#8217;. When minimized, simply hovering over the left side will temporarily maximize the space.<\/p>\n\n\n\n<p>The component window allows m-Painter users to add a variety of features to the presentation layer of your application. <\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" src=\"\/docs\/images\/paintercomponentpanel.png\" alt=\"\"\/><\/figure>\n\n\n\n<h3 class=\"wp-block-heading\">Fields<\/h3>\n\n\n\n<p>You can always add a field substitution to the current location of your cursor by clicking on the cursor icon directly next to the field you would like to add. Clicking the arrow, by contrast, will append this field as a new column, complete with appropriate column heading, to the end of your main data table.<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" src=\"\/docs\/images\/painterfields.png\" alt=\"\"\/><\/figure>\n\n\n\n<h3 class=\"wp-block-heading\">Retrieve Additional Data<\/h3>\n\n\n\n<p>All features in this area focus on using ancillary applications to bring back data into your current application.<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" src=\"\/docs\/images\/painterretrieve.png\" alt=\"\"\/><\/figure>\n\n\n\n<h4 class=\"wp-block-heading\">Data Lists<\/h4>\n\n\n\n<p>Useful if you wish to join your application out to a separate application to bring in additional data. First off click in the cell you wish to return data. Then click the Data List feature, map your application. Once you make the connection, go back into that cell and return to the Fields list. Here you should now see all fields from your linked application, available to include into your chosen cell.<\/p>\n\n\n\n<p>To learn more about Data Lists, please see <a href=\"\/docs\/knowledge-base\/data-lists\" data-type=\"URL\" data-id=\"\/docs\/knowledge-base\/data-lists\" target=\"_blank\" rel=\"noreferrer noopener\">here<\/a>.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">Key\/Value Lookup<\/h4>\n\n\n\n<p>This feature is helpful if you want to replace an existing field on the screen with a value being returned from another application. An example of this might be to show a status name on screen, rather than just the status code.<\/p>\n\n\n\n<p>Learn more about this feature <a rel=\"noreferrer noopener\" href=\"https:\/\/www.mrc-productivity.com\/docs\/knowledge-base\/key-pairs\" target=\"_blank\">here<\/a>.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">Totals &amp; Percentages<\/h4>\n\n\n\n<p>This feature will retrieve a single grand total value from a report or data model and insert it into the location you have selected in the page<\/p>\n\n\n\n<p>Learn more about this feature <a href=\"https:\/\/www.mrc-productivity.com\/docs\/knowledge-base\/insert-totals-percentages\" target=\"_blank\" rel=\"noreferrer noopener\">here<\/a>.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">Import Content from Another App<\/h4>\n\n\n\n<p>This feature allows you to include HTML content from another application<\/p>\n\n\n\n<p>Learn more about importing <a href=\"https:\/\/www.mrc-productivity.com\/docs\/knowledge-base\/working-with-the-m-painter-import-panel\" target=\"_blank\" rel=\"noreferrer noopener\">here<\/a>.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Featured Components<\/h3>\n\n\n\n<p>These HTML features allow you to place a variety of HTML elements within the page. These items are listed as &#8220;Featured&#8221; as they enhance the user experience.<\/p>\n\n\n\n<p>Learn more about the Featured Components <a href=\"https:\/\/www.mrc-productivity.com\/docs\/knowledge-base\/featured-component-selector\" target=\"_blank\" rel=\"noreferrer noopener\">here<\/a>.<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" src=\"\/docs\/images\/painterfeatured.png\" alt=\"\"\/><\/figure>\n\n\n\n<h4 class=\"wp-block-heading\">Button<\/h4>\n\n\n\n<p>Adds a clickable element to the page. You can then make the button a Smartlink or use it with conditional rendering to have items show\/hide based on if the button is clicked.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">Card<\/h4>\n\n\n\n<p>A container with a colorful heading. If you wish to put the current content into a card, click on it and select the blue square within the main edit window and follow the prompts.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">Tabs<\/h4>\n\n\n\n<p>A multi tab container. If you wish to put the current content into a tab, click on it and select the blue square within the main edit window. To add more tabs, click on the tab itself, then select \u201cAdd tab\u201d from the right-side menu.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">Stat Widget<\/h4>\n\n\n\n<p>Useful for making bold dashboard entries. Add it to your application, then use substitutions to put live values into your application. All styling and icons are automatically presented for you.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">Icon<\/h4>\n\n\n\n<p>A variety of Font Awesome icons available to add to your application. You can style this element to change its size, color, etc.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">Image<\/h4>\n\n\n\n<p>If you want to add an image to your application, use this screen to point m-Painter to the path of your image.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">Badge<\/h4>\n\n\n\n<p>Used to add emphasis to text or a number on the page. Often used as a form of &#8220;Notification Badge&#8221;.<\/p>\n\n\n\n<p>Learn more about Notification Badges <a href=\"https:\/\/www.mrc-productivity.com\/docs\/knowledge-base\/notification-badges\">here<\/a>.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">Status<\/h4>\n\n\n\n<p>Statues are tied to workflow objects within Maintenance applications. However, adding a status field allows you to utilize status workflows built within other applications.<\/p>\n\n\n\n<p>Click <a href=\"https:\/\/www.mrc-productivity.com\/docs\/knowledge-base\/workflow-statuses\" target=\"_blank\" rel=\"noreferrer noopener\">here<\/a> to learn more about the Status feature.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">Data List<\/h4>\n\n\n\n<p>In the event you removed your main data table, and wish to use a different UI layout, choose this option.<\/p>\n\n\n\n<p>Learn more about this feature <a href=\"https:\/\/www.mrc-productivity.com\/docs\/knowledge-base\/data-list\" target=\"_blank\" rel=\"noreferrer noopener\">here<\/a>.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Generic UI Components<\/h3>\n\n\n\n<p>These are basic HTML components that have been put on a menu to allow you to easily add them to your page, without having to go into the HTML code.<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" src=\"\/docs\/images\/paintergeneric.png\" alt=\"\"\/><\/figure>\n\n\n\n<h4 class=\"wp-block-heading\">Row\/Column<\/h4>\n\n\n\n<p>Inserts a blank Bootstrap row and column at the current cursor position. This is useful when working with the layout of the page.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">Container<\/h4>\n\n\n\n<p>Inserts a blank div at the current cursor position.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">Text<\/h4>\n\n\n\n<p>Inserts a wrapped span element at the cursor position and allows you to change the placeholder text after inserting.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">Pulldown Menu<\/h4>\n\n\n\n<p>Insert a pulldown menu which allows you to configure multiple hyperlinks within a single element.<\/p>\n\n\n\n<p>Learn more about Pulldown Menus <a href=\"https:\/\/www.mrc-productivity.com\/docs\/knowledge-base\/notification-badges\" target=\"_blank\" rel=\"noreferrer noopener\">here<\/a>.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">Table<\/h4>\n\n\n\n<p>Adds a table to the cursor position. Once the default table is inserted, select the table and use the Element Panel to merge cells or add columns. <\/p>\n\n\n\n<h4 class=\"wp-block-heading\">Alert<\/h4>\n\n\n\n<p>Provide contextual feedback messages for typical user actions with a handful of available styling options. After inserting the alert element, select the element and change the style from the right-side &#8220;Alert Style&#8221; option.<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" src=\"\/docs\/images\/alerts.jpg\" alt=\"\"\/><\/figure>\n\n\n\n<h3 class=\"wp-block-heading\">Application Components<\/h3>\n\n\n\n<p>Applications have several areas (prompt pages filters, total levels, data tables, etc). This area can help you quickly navigate to the area you would like to work with. Additionally, in the event you \u201cClear Page Contents\u201d from the Page Options menu, this option lets you add entire sections back into your page via the pointer icon.<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" src=\"\/docs\/images\/painterappcomponents.png\" alt=\"\"\/><\/figure>\n\n\n\n<h2 class=\"wp-block-heading\">Editing Panel<\/h2>\n\n\n\n<p>This is where you will spend most of your time editing your application. Based on what you click on in this panel, different options will be available to you within the right side menu. There is no right-click context menu. In an effort to ensure maximum visibility for various options, no right click context menu is used.<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" src=\"\/docs\/images\/painteredit.png\" alt=\"\"\/><\/figure>\n\n\n\n<h3 class=\"wp-block-heading\">Blue Menu (selected element)<\/h3>\n\n\n\n<p>When you click within any element, a blue menu will appear. You can click again to hide it if necessary.<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" src=\"\/docs\/images\/painterblue.png\" alt=\"\"\/><\/figure>\n\n\n\n<p><strong>Quick edit \u2013 <\/strong>Depending on the element type, a quick edit option will be available to you allowing you to modify the selected element without having to go to the right panel.<\/p>\n\n\n\n<p><strong>Up arrow \u2013 <\/strong>this lets you go the parent item of the currently selected element.<\/p>\n\n\n\n<p><strong>Box \u2013<\/strong> This lets you wrap the selected element inside of a card, tab, or simple DIV element.<\/p>\n\n\n\n<p><strong>Trash \u2013<\/strong> Removes the current element. m-Painter is smart enough to remove the entire column if the current selected element is a table cell.<\/p>\n\n\n\n<p><strong>Label \u2013<\/strong> Indicates what element you have selected.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Green Menu (hovered element)<\/h3>\n\n\n\n<p>When the grid option is checked, any element hovered on will show a green menu. You can remove this green menu by hovering off of the element or simply unchecking the grid option.<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" src=\"\/docs\/images\/paintergreen.png\" alt=\"\"\/><\/figure>\n\n\n\n<p><strong>Label \u2013<\/strong> Indicates what element you have hovered on.<\/p>\n\n\n\n<p><strong>Insert row above \u2013 <\/strong>Adds a row directly above the current selected element.<\/p>\n\n\n\n<p><strong>Insert row below \u2013 <\/strong>Adds a row directly after the current selected element.<\/p>\n\n\n\n<p><strong>Insert column to the left <\/strong>\u2013 Adds a column directly before the current selected element.<\/p>\n\n\n\n<p><strong>Insert column to the right <\/strong>\u2013 Adds a column directly after the current selected element.<\/p>\n\n\n\n<p><strong>Increase column width<\/strong> \u2013 Available on non-table elements \u2013 this allows the container to use more space of the 12 available columns on the page.<\/p>\n\n\n\n<p><strong>Decrease column width \u2013 <\/strong>Available on non-table elements \u2013 this allows the container to use less space of the 12 available columns on the page.<\/p>\n\n\n\n<p><strong>Wrap element in container<\/strong> \u2013 Available on non-table elements \u2013 allows you to wrap the selected element into a card, tab, or plain DIV.<\/p>\n\n\n\n<p><strong>Removes content \u2013 <\/strong>Removes selected content from page.&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Other Notes<\/h2>\n","protected":false},"excerpt":{"rendered":"<p>The goal of this document is to present the m-Power developer with all available options within m-Painter.<\/p>\n","protected":false},"author":1,"comment_status":"closed","ping_status":"closed","template":"","format":"standard","meta":{"footnotes":""},"ht-kb-category":[255],"ht-kb-tag":[],"class_list":["post-1420","ht_kb","type-ht_kb","status-publish","format-standard","hentry","ht_kb_category-mpainter"],"_links":{"self":[{"href":"https:\/\/www.mrc-productivity.com\/docs\/wp-json\/wp\/v2\/ht-kb\/1420","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.mrc-productivity.com\/docs\/wp-json\/wp\/v2\/ht-kb"}],"about":[{"href":"https:\/\/www.mrc-productivity.com\/docs\/wp-json\/wp\/v2\/types\/ht_kb"}],"author":[{"embeddable":true,"href":"https:\/\/www.mrc-productivity.com\/docs\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.mrc-productivity.com\/docs\/wp-json\/wp\/v2\/comments?post=1420"}],"version-history":[{"count":104,"href":"https:\/\/www.mrc-productivity.com\/docs\/wp-json\/wp\/v2\/ht-kb\/1420\/revisions"}],"predecessor-version":[{"id":14242,"href":"https:\/\/www.mrc-productivity.com\/docs\/wp-json\/wp\/v2\/ht-kb\/1420\/revisions\/14242"}],"wp:attachment":[{"href":"https:\/\/www.mrc-productivity.com\/docs\/wp-json\/wp\/v2\/media?parent=1420"}],"wp:term":[{"taxonomy":"ht_kb_category","embeddable":true,"href":"https:\/\/www.mrc-productivity.com\/docs\/wp-json\/wp\/v2\/ht-kb-category?post=1420"},{"taxonomy":"ht_kb_tag","embeddable":true,"href":"https:\/\/www.mrc-productivity.com\/docs\/wp-json\/wp\/v2\/ht-kb-tag?post=1420"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}