Edit D:\app\Administrator\product\11.2.0\dbhome_1\apex\images\doc\ui_region_layout.htm
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> <head> <meta http-equiv="Content-Type" content="text/html; charset=us-ascii" /> <meta http-equiv="Content-Style-Type" content="text/css" /> <meta http-equiv="Content-Script-Type" content="text/javascript" /> <title>Editing Region Attributes</title> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 5.1" /> <meta name="date" content="2009-04-14T16:11:30Z" /> <meta name="robots" content="noarchive" /> <meta name="doctitle" content="Editing Region Attributes" /> <meta name="relnum" content="Release 3.2" /> <meta name="partnum" content="E11947-01" /> <link rel="copyright" href="dcommon/html/cpyr.htm" title="Copyright" type="text/html" /> <link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" /> <link rel="contents" href="toc.htm" title="Contents" type="text/html" /> <link rel="up" href="preface.htm" title="Home" type="text/html" /> <link rel="up" href="ui.htm" title="Controlling Page Layout" type="text/html" /> <link rel="up" href="ui_region.htm" title="Understanding Regions" type="text/html" /> <link rel="up" href="ui_region_layout.htm" title="Editing Region Attributes" type="text/html" /> <link rel="prev" href="ui_region_reorder.htm" title="Previous" type="text/html" /> <link rel="next" href="ui_region_create.htm" title="Next" type="text/html" /> </head> <body> <p id="BREADCRUMBING"><a href="preface.htm" title="Home">Home</a> > <a href="ui.htm" title="Controlling Page Layout">Controlling Page Layout</a> > <a href="ui_region.htm" title="Understanding Regions">Understanding Regions</a> > Editing Region Attributes</p> <table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%"> <col width="86%" /> <col width="*" /> <tr valign="bottom"> <td align="left"></td> <td align="center"><a href="ui_region_reorder.htm"><img src="dcommon/gifs/leftnav.gif" alt="Previous" /><br /> <span class="icon">Previous</span></a> </td> <td align="center"><a href="ui_region_create.htm"><img src="dcommon/gifs/rightnav.gif" alt="Next" /><br /> <span class="icon">Next</span></a></td> </tr> </table> <p><a id="BABGCBHG" name="BABGCBHG"></a></p> <div class="sect2"><!-- infolevel="all" infotype="General" --> <h1><a name="HTMDB25567" id="HTMDB25567"></a>Editing Region Attributes</h1> <p>You can alter the appearance of a page by editing attributes on the Region Definition.</p> <a id="sthref1454" name="sthref1454"></a> <p class="subhead2">Topics:</p> <ul> <li> <p><a href="#CHDCBBED">Editing a Region Definition</a></p> </li> <li> <p><a href="#CHDDCACH">How Region Attributes Affect Page Layout</a></p> </li> <li> <p><a href="ui_region_reorder.htm#CHDIHFIF">Using the Reorder Regions Icon</a></p> </li> <li> <p><a href="#CHDFDCFJ">Controlling Region Positioning</a></p> </li> <li> <p><a href="#CHDDGGEG">Specifying a Region Header and Footer</a></p> </li> <li> <p><a href="#BABECCAE">Enabling Users to Customize a Page</a></p> </li> <li> <p><a href="#BABEIJBF">Utilizing Region Caching</a></p> </li> <li> <p><a href="#BABBEJJD">Specifying a Static Region ID</a></p> </li> </ul> <a id="CHDCBBED" name="CHDCBBED"></a> <div class="sect3"><!-- infolevel="all" infotype="General" --> <h2><a name="HTMDB25568" id="HTMDB25568"></a>Editing a Region <a id="sthref1455" name="sthref1455"></a>Definition</h2> <p>To edit region attributes:</p> <ol> <li> <p>Navigate to the appropriate Page Definition. See <a href="bldr_goto_pgdef.htm#CJGHCACC">"Accessing a Page Definition"</a>.</p> </li> <li> <p>Under Regions, select the region name.</p> <p>The Region Definition appears.</p> </li> <li> <p>Edit the appropriate attributes.</p> </li> <li> <p>To learn more about a specific item on a page, click the item label.</p> <p>When Help is available, the item label changes to red when you pass your cursor over it and the cursor changes to an arrow and question mark. See <a href="start_hlp.htm#BABDGBDB">"About Field-Level Help"</a>.</p> </li> <li> <p>Click <span class="bold">Apply Changes</span>.</p> </li> </ol> <div align="center"> <div class="inftblnotealso"><br /> <table class="NoteAlso oac_no_warn" summary="" cellpadding="3" cellspacing="0"> <tbody> <tr> <td align="left"> <p class="notep1">See Also:</p> <a href="#CHDDCACH">"How Region Attributes Affect Page Layout"</a>, <a href="#CHDFDCFJ">"Controlling Region Positioning"</a>, <a href="ui_region_reorder.htm#CHDIHFIF">"Using the Reorder Regions Icon"</a>, and <a href="#CHDDGGEG">"Specifying a Region Header and Footer"</a></td> </tr> </tbody> </table> <br /></div> <!-- class="inftblnotealso" --></div> <div class="sect4"><!-- infolevel="all" infotype="General" --><a id="sthref1456" name="sthref1456"></a> <h3><a name="HTMDB25569" id="HTMDB25569"></a>About Navigation Alternatives</h3> <p>The Region Definition page is divided into the following sections: Identification, User Interface, Source, Conditions, Cache, Header and Footer, Authorization, Customization, Configuration, and Comments.</p> <p>You can access these sections by scrolling down the page, or by clicking a navigation button at the top of the page. When you select a button at the top of the page, the selected section appears and all other sections are temporarily hidden. To view all sections of the page, click <span class="bold">Show All</span>.</p> </div> <!-- class="sect4" --></div> <!-- class="sect3" --> <a id="CHDDCACH" name="CHDDCACH"></a> <div class="sect3"><!-- infolevel="all" infotype="General" --> <h2><a name="HTMDB25570" id="HTMDB25570"></a>How Region Attributes Affect Page Layout</h2> <p><a href="#BGBEBHFE">Table: Region Attributes Affecting Page Layout</a> describes region attributes that affect the layout of a page.</p> <div class="tblformalwide"><a id="sthref1457" name="sthref1457"></a><a id="BGBEBHFE" name="BGBEBHFE"></a> <p class="titleintable">Region Attributes Affecting Page Layout</p> <table class="FormalWide" title="Region Attributes Affecting Page Layout" summary="This table describes how region attributes affect the layout of a page." dir="ltr" border="1" width="100%" frame="hsides" rules="groups" cellpadding="3" cellspacing="0"> <col width="36%" /> <col width="*" /> <thead> <tr align="left" valign="top"> <th align="left" valign="bottom" id="r1c1-t7">Attribute</th> <th align="left" valign="bottom" id="r1c2-t7">Description</th> </tr> </thead> <tbody> <tr align="left" valign="top"> <td align="left" id="r2c1-t7" headers="r1c1-t7"> <p><a id="sthref1458" name="sthref1458"></a>User Interface, Template</p> </td> <td align="left" headers="r2c1-t7 r1c2-t7"> <p>Determines the look of the region. Select from the region templates defined in the application. To view template attributes, click the template name on the Page Definition.</p> <p><span class="bold">See Also:</span> <a href="ui_templt.htm#BABBFHJA">"Customizing Templates"</a> and <a href="ui_templt_reg.htm#BABCHHFG">"Region Templates"</a></p> </td> </tr> <tr align="left" valign="top"> <td align="left" id="r3c1-t7" headers="r1c1-t7"> <p><a id="sthref1459" name="sthref1459"></a>User Interface, Sequence</p> </td> <td align="left" headers="r3c1-t7 r1c2-t7"> <p>Specifies the display order of the regions within the page.</p> </td> </tr> <tr align="left" valign="top"> <td align="left" id="r4c1-t7" headers="r1c1-t7"> <p><a id="sthref1460" name="sthref1460"></a>User Interface, Display Point</p> </td> <td align="left" headers="r4c1-t7 r1c2-t7"> <p>Identifies where the region displays within the page. Regions are rendered in order of sequence number within a Display Point. Click the View icon to see the page layout and select a position.</p> <p>The possible display points for a region are determined by the page-level template (which is a page attribute). If no page-level template is selected, the default page-level template, defined in the Application Definition, is used.</p> </td> </tr> <tr align="left" valign="top"> <td align="left" id="r5c1-t7" headers="r1c1-t7"> <p><a id="sthref1461" name="sthref1461"></a>User Interface, Region HTML table cell attributes</p> </td> <td align="left" headers="r5c1-t7 r1c2-t7"> <p>Defines additional attributes to be used in the HTML table cells when regions display in multiple columns. The attributes control the cells in the table used to lay out a region in multiple columns.</p> </td> </tr> <tr align="left" valign="top"> <td align="left" id="r6c1-t7" headers="r1c1-t7"> <p><a id="sthref1462" name="sthref1462"></a>User Interface, Column</p> </td> <td align="left" headers="r6c1-t7 r1c2-t7"> <p>Determines the column where the region displays. If two regions are in the same display point, you can place them next to one another by setting the second region to display in column 2. Many regions can display in each column and the display order of the regions within the region display point and column is controlled by the region display sequence number.</p> </td> </tr> <tr align="left" valign="top"> <td align="left" id="r7c1-t7" headers="r1c1-t7"> <p><a id="sthref1463" name="sthref1463"></a><a id="sthref1464" name="sthref1464"></a>Header and Footer</p> </td> <td align="left" headers="r7c1-t7 r1c2-t7"> <p>Specifies HTML text to be displayed at the top of the region (just before the <code>#BODY#</code> content).</p> </td> </tr> <tr align="left" valign="top"> <td align="left" id="r8c1-t7" headers="r1c1-t7"> <p><a id="sthref1465" name="sthref1465"></a><a id="sthref1466" name="sthref1466"></a><a id="sthref1467" name="sthref1467"></a><a id="sthref1468" name="sthref1468"></a>Conditional Display</p> </td> <td align="left" headers="r8c1-t7 r1c2-t7"> <p>Defines conditions and appropriate expressions that determine if the region displays. Conditions can reference session state, the currently logged in user, or environment preferences (such as whether a page is in Print View mode).</p> <p><span class="bold">See Also:</span> <a href="concept_cond_process.htm#BEIEBEHI">"Understanding Conditional Rendering and Processing"</a> and <a href="ui_print_pg.htm#CHDDAACI">"Optimizing a Page for Printing"</a></p> </td> </tr> <tr align="left" valign="top"> <td align="left" id="r9c1-t7" headers="r1c1-t7"> <p><a id="sthref1469" name="sthref1469"></a>Customization</p> </td> <td align="left" headers="r9c1-t7 r1c2-t7"> <p>Enables end-user customization. To utilize this feature, you must include the <code>#CUSTOMIZE#</code> substitution string in the Header, Body, or Footer section of the page template.</p> <p><span class="bold">See Also:</span> <a href="#BABECCAE">"Enabling Users to Customize a Page"</a></p> </td> </tr> </tbody> </table> <br /></div> <!-- class="tblformalwide" --> <a id="CHDFDCFJ" name="CHDFDCFJ"></a> <div class="sect4"><!-- infolevel="all" infotype="General" --> <h3><a name="HTMDB25571" id="HTMDB25571"></a>Controlling <a id="sthref1470" name="sthref1470"></a>Region Positioning</h3> <p>When you create a region, you must specify its position (or Display Point) on the page. You can choose either a default position (such as Page Template Body) or a user-defined position in the template (such as Page Template Region Position 1.)</p> <p>In addition to Display Point, you can specify the column in which the region will be placed. When you place regions in multiple columns, Oracle Application Express automatically renders the necessary HTML to produce a multiple column layout.</p> </div> <!-- class="sect4" --></div> <!-- class="sect3" --> <a id="CHDDGGEG" name="CHDDGGEG"></a> <div class="sect3"><!-- infolevel="all" infotype="General" --> <h2><a name="HTMDB25572" id="HTMDB25572"></a>Specifying a <a id="sthref1471" name="sthref1471"></a><a id="sthref1472" name="sthref1472"></a><a id="sthref1473" name="sthref1473"></a>Region Header and Footer</h2> <p>In addition to the body content of a region (which can be a report, a chart, or HTML with form elements), you can specify additional HTML to be placed above and below a region or in its header and footer.</p> <p>The region footer supports the following substitution strings:</p> <ul> <li> <p><code>#TIMING#</code> shows the elapsed time in seconds used when rendering a region. You can use this substitution string for debugging purposes.</p> </li> <li> <p><code>#ROWS_FETCHED#</code> shows the number of rows fetched by the Oracle Application Express reporting engine (the page size). You can use these substitution strings to display customized messages to the user. For example:</p> <pre xml:space="preserve" class="oac_no_warn"> Fetched #ROWS_FETCHED# rows in #TIMING# seconds. </pre></li> <li> <p><code>#TOTAL_ROWS#</code> displays the total number of rows that satisfy a SQL query used for a report.</p> </li> <li> <p><code>#FIRST_ROW_FETCHED#</code> and <code>#LAST_ROW_FETCHED#</code> display the range of rows displayed. For example:</p> <pre xml:space="preserve" class="oac_no_warn"> Row(s) #FIRST_ROW_FETCHED# through #LAST_ROW_FETCHED# of #ROWS_FETCHED# displayed </pre></li> </ul> </div> <!-- class="sect3" --> <a id="BABECCAE" name="BABECCAE"></a> <div class="sect3"><!-- infolevel="all" infotype="General" --> <h2><a name="HTMDB25573" id="HTMDB25573"></a>Enabling Users to Customize a Page<a id="sthref1474" name="sthref1474"></a><a id="sthref1475" name="sthref1475"></a></h2> <p>You can use the Customization attribute to enable users to turn regions on and off in a running application.</p> <p>To enable end-user customization:</p> <ol> <li> <p>Navigate to the appropriate Page Definition. See <a href="bldr_goto_pgdef.htm#CJGHCACC">"Accessing a Page Definition"</a>.</p> </li> <li> <p>Under Regions, click the region name.</p> <p>The Region Definition appears.</p> </li> <li> <p>Scroll down to Customization and select one of the following:</p> <ul> <li> <p><span class="bold">Customizable and Not Shown By Default</span></p> </li> <li> <p><span class="bold">Customizable and Shown By Default</span></p> </li> </ul> </li> <li> <p>In Customized Option Name, enter the label that represents this region on the page to the user.</p> </li> <li> <p>Include the <code>#CUSTOMIZE#</code> substitution string in the Header, Body, or Footer section of the page template.</p> </li> </ol> <p>To use this feature, you must include the <code>#CUSTOMIZE#</code> substitution string in the Header, Body, or Footer section of the page template.</p> <p>If at least one region supports end-user customization, a link called Customize appears wherever you include the <code>#CUSTOMIZE#</code> substitution string in the page template. When users click this link, a window appears, enabling them to turn on and off regions on the page.</p> <div align="center"> <div class="inftblnotealso"><br /> <table class="NoteAlso oac_no_warn" summary="" cellpadding="3" cellspacing="0"> <tbody> <tr> <td align="left"> <p class="notep1">See Also:</p> <a href="ui_templt.htm#BABBFHJA">"Customizing Templates"</a></td> </tr> </tbody> </table> <br /></div> <!-- class="inftblnotealso" --></div> </div> <!-- class="sect3" --> <a id="BABEIJBF" name="BABEIJBF"></a> <div class="sect3"><!-- infolevel="all" infotype="General" --> <h2><a name="HTMDB25574" id="HTMDB25574"></a>Utilizing Region <a id="sthref1476" name="sthref1476"></a><a id="sthref1477" name="sthref1477"></a>Caching</h2> <p>Enabling region caching is an effective way improve the performance of static regions such as regions containing lists that do not use conditions or regions containing static HTML.</p> <div align="center"> <div class="inftblnotealso"><br /> <table class="NoteAlso oac_no_warn" summary="" cellpadding="3" cellspacing="0"> <tbody> <tr> <td align="left"> <p class="notep1">Tip:</p> Region caching is not available for interactive report regions. See <a href="bldapp_rpt_int.htm#CHDEFABF">"Editing Interactive Reports"</a>.</td> </tr> </tbody> </table> <br /></div> <!-- class="inftblnotealso" --></div> <p>When you enable region caching, the Application Express engine renders a region from a cached (or stored) respository instead of rendering it dynamically. Keep in mind that the actual session identifiers are not cached. Instead, the Application Express engine caches a <code>&SESSION.</code> substitution string and the current session rendering the cached region is substituted on display. For example, if a region contains a link and the link includes a session, the exact session is not cached to ensure that the links works for all sessions.</p> <p>The Application Express engine only renders a region from cache if it meets the defined condition. Additionally, regions can be cached specific to a user or cached independent of a user.</p> <div align="center"> <div class="inftblnotealso"><br /> <table class="NoteAlso oac_no_warn" summary="" cellpadding="3" cellspacing="0"> <tbody> <tr> <td align="left"> <p class="notep1">See Also:</p> <a href="bldr_pg_att_about.htm#BGBGFJBF">"Cache"</a></td> </tr> </tbody> </table> <br /></div> <!-- class="inftblnotealso" --></div> <div class="sect4"><!-- infolevel="all" infotype="General" --><a id="sthref1478" name="sthref1478"></a> <h3><a name="HTMDB25575" id="HTMDB25575"></a>Enabling Region Caching</h3> <p>To enable region caching:</p> <ol> <li> <p>Navigate to the appropriate Page Definition. See <a href="bldr_goto_pgdef.htm#CJGHCACC">"Accessing a Page Definition"</a>.</p> </li> <li> <p>Under Regions, click the region name.</p> <p>The Region Definition appears.</p> </li> <li> <p>Scroll down to Cache and specify the following:</p> <ol> <li> <p>Caching - Select <span class="bold">Cached</span> to cache the region independent of the user. Select <span class="bold">Cached by User</span> to cache the region specific to a given user.</p> </li> <li> <p>Timeout Cache After - Identify how long the cached region remains valid.</p> </li> <li> <p>Cache Condition Type - Select a condition type from the list. If the condition returns false, the region is rendered dynamically and is not be cached. If the condition returns true, the region is cached.</p> </li> <li> <p>Expression 1 and Expression 2 - Enter values based on the specific condition type selected.</p> </li> </ol> </li> <li> <p>Click <span class="bold">Apply Changes</span>.</p> </li> </ol> </div> <!-- class="sect4" --></div> <!-- class="sect3" --> <a id="BABBEJJD" name="BABBEJJD"></a> <div class="sect3"><!-- infolevel="all" infotype="General" --> <h2><a name="HTMDB25576" id="HTMDB25576"></a>Specifying a Static <a id="sthref1479" name="sthref1479"></a>Region ID</h2> <p>Specifying a static region ID is useful when creating custom JavaScript or cascading stylesheets. You can use the Static ID attribute on the Edit Region page to uniquely identify a region. You can then reference the region using the <code>#REGION_STATIC_ID#</code> substitution string in a region templates, the header, the footer, or the body.</p> <p>To specify a static region ID:</p> <ol> <li> <p>Navigate to the appropriate Page Definition. See <a href="bldr_goto_pgdef.htm#CJGHCACC">"Accessing a Page Definition"</a>.</p> <p>The Region Definition appears.</p> </li> <li> <p>Under Identification, enter a value in Static ID.</p> </li> <li> <p>Click <span class="bold">Apply Changes</span>.</p> </li> </ol> </div> <!-- class="sect3" --></div> <!-- class="sect2" --> <!-- Start Footer --> <div class="footer"> <table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%"> <col width="86%" /> <col width="*" /> <tr> <td align="left"><span class="copyrightlogo">Copyright © 2003, 2009, Oracle and/or its affiliates. All rights reserved.</span><br /> <a href="dcommon/html/cpyr.htm"><span class="copyrightlogo">Legal Notices</span></a></td> <td align="center"><a href="ui_region_reorder.htm"><img src="dcommon/gifs/leftnav.gif" alt="Previous" /><br /> <span class="icon">Previous</span></a> </td> <td align="center"><a href="ui_region_create.htm"><img src="dcommon/gifs/rightnav.gif" alt="Next" /><br /> <span class="icon">Next</span></a></td> </tr> </table> </div> <!-- class="footer" --> </body> </html>
Ms-Dos/Windows
Unix
Write backup
jsp File Browser version 1.2 by
www.vonloesch.de