<!DOCTYPE html
  PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">

<!--
Copyright (c) 2006 UGS Corp.

All Rights Reserved.

This software and related documentation are proprietary to UGS Corp.
-->
<html>
   <head>
      <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
      <title>Make a palette entry transferable</title>
      <script language="javaScript">
        abridged="false";
        displayConditions=new Array();
      </script>
      <link type="text/css" href="../css/main_styles.css" rel="stylesheet">
   </head>
   <body class="bodydocs" onload="top.pageLoader()" bgcolor="#FFFFFF">
      <div class="title_topic8" id="xps10_pagetitle">Make a palette entry transferable</div>
      <hr noshade="true">
      <table cellspacing="4" align="center">
         <tr valign="top">
            <td bgcolor="#f4f4f4" colspan="1" rowspan="1">
               <p class="para_td"> <a class="links" href="javascript:void(0)" onclick="top.openFile('intro_to_nx/uiu_ab_pal_prt_ov.html');return(false);">Overview</a></p>
            </td>
            <td bgcolor="#f4f4f4" colspan="1" rowspan="1">
               <p class="para_td"> <a class="links" href="javascript:void(0)" onclick="top.openFile('intro_to_nx/uiu_ab_pal_prt_p.html');return(false);">How To</a></p>
            </td>
            <td bgcolor="#f4f4f4" colspan="1" rowspan="1">
               <p class="para_td"> <a class="links" href="javascript:void(0)" onclick="top.openFile('intro_to_nx/uiu_ab_pal_prt_rt.html');return(false);">Related Topics</a></p>
            </td>
         </tr>
      </table><br><p class="para_topic">This topic describes how to make a palette entry transferable and the four available transferable attributes.</p>
      <div class="title_division">Syntax</div>
      <p class="para_division">To make a palette entry transferable, use one of the following methods:</p>
      <div class="title_division">Use the &lt;Filename&gt; tag</div>
      <p class="para_division">When you reference a path and filename, surround it with the &lt;Filename&gt; tag, as shown below:</p><pre class="indent"> &lt;ObjectData class=&quot;Inferred&quot;&gt; &lt;Filename&gt;c:\my_dir/part_2.prt&lt;/Filename&gt; &lt;/ObjectData&gt; </pre><p class="para_division">When you use the &lt;Filename&gt; tag, the system adds a transferable attribute and sets it to yes, as shown below:</p><pre class="indent"> &lt;ObjectData class=&quot;Inferred&quot;&gt; &lt;Filename transferable=&quot;yes&quot;&gt;c:\my_dir/part_2.prt&lt;/Filename&gt; &lt;/ObjectData&gt; </pre><div class="title_division">Use the location attribute</div>
      <p class="para_division">When you reference a path and filename, use the location attribute, as shown below:</p><pre class="indent"> &lt;MyspecialFile location=c:\temp\myfile.txt/&gt; </pre><p class="para_division">When you use the &quot;location&quot; attribute, the system adds and sets the &quot;transferable&quot; attribute to the parent tag and sets it to &quot;yes&quot;, as shown below:</p><pre class="indent"> &lt;MyspecialFile transferable=&quot;yes&quot; location=c:\temp\myfile.txt/&gt; </pre><p class="para_division">When you set a transferable attribute to yes, it makes the value of a &lt;Filename&gt; tag or location= attribute dynamic.</p>
      <table border="0">
         <tr>
            <td valign="top" align="left"><img align="left" src="../graphics/note.gif" alt="Note" title="Note"></td>
            <td valign="bottom" align="left" width="100%">
               <div class="para_note">
                  <p class="para_note_body">If you manually edit your palette files, making the paths relative instead of absolute, the system will always be able to resolve the paths. This allows you to edit them once and not have to edit them again.</p>
               </div>
            </td>
         </tr>
      </table>
      <div class="title_division">Transferable attributes</div>
      <p class="para_division">You can set the transferable attribute to any of values in the following table.</p>
      <table cellspacing="3" width="100%" align="center">
         <tr>
            <th bgcolor="#c0c0c0" colspan="1" rowspan="1" valign="top">
               <p class="para_th">Attribute</p>
            </th>
            <th bgcolor="#c0c0c0" colspan="1" rowspan="1" valign="top">
               <p class="para_th">Description</p>
            </th>
         </tr>
         <tr>
            <td bgcolor="#f4f4f4" colspan="1" rowspan="1" valign="top">
               <p class="para_td">yes</p>
            </td>
            <td bgcolor="#f4f4f4" colspan="1" rowspan="1" valign="middle">
               <p class="para_td">Makes an entry transferable.</p>
            </td>
         </tr>
         <tr>
            <td bgcolor="#f4f4f4" colspan="1" rowspan="1" valign="top">
               <p class="para_td">no</p>
            </td>
            <td bgcolor="#f4f4f4" colspan="1" rowspan="1" valign="middle">
               <p class="para_td">Makes an entry not transferable.</p>
            </td>
         </tr>
         <tr>
            <td bgcolor="#f4f4f4" colspan="1" rowspan="1" valign="top">
               <p class="para_td">all_yes</p>
            </td>
            <td bgcolor="#f4f4f4" colspan="1" rowspan="1" valign="middle">
               <p class="para_td">Makes all subsequent entries transferable until the system reaches an entry that contains a transferable attribute that is set to all_no or no.</p>
            </td>
         </tr>
         <tr>
            <td bgcolor="#f4f4f4" colspan="1" rowspan="1" valign="top">
               <p class="para_td">all_no</p>
            </td>
            <td bgcolor="#f4f4f4" colspan="1" rowspan="1" valign="middle">
               <p class="para_td">Makes all subsequent entries not transferable until the system reaches an entry that contains a transferable attribute that is set to all_yes or yes.</p>
            </td>
         </tr>
      </table><br><div class="title_division">Sample 1</div>
      <p class="para_division">The following XML sample sets all the files within &lt;ObjectData&gt; as transferable.</p><pre class="indent"> &lt;ObjectData class=&quot;aaaa&quot;&gt; &lt;SomeType&gt;wwwww&lt;/SomeType&gt; &lt;Filename transferable=&quot;yes&quot;&gt;qweet.lst&lt;/Filename&gt; &lt;Views transferable=&quot;all_yes&quot;&gt; &lt;TopImage location=&quot;top.tif&quot;/&gt; &lt;LeftImage location=&quot;left.tif&quot;/&gt; &lt;RightImage location=&quot;right.tif&quot;/&gt; . &lt;BottomImage location=&quot;bottom.tif&quot;/&gt; &lt;/Views&gt; &lt;/ObjectData&gt; </pre><div class="title_division">Sample 2</div>
      <p class="para_division">The following XML sample sets entries as transferable until c:\ug\ref\refname.txt.</p><pre class="indent"> &lt;ObjectData class=&quot;aaaa&quot;&gt; &lt;SomeType&gt;wwwww&lt;/SomeType&gt; &lt;Filename transferable=&quot;yes&quot;&gt;qweet.lst&lt;/Filename&gt; &lt;Views transferable=&quot;all_yes&quot;&gt; &lt;TopImage location=&quot;top.tif&quot;/&gt; &lt;LeftImage location=&quot;left.tif&quot;/&gt; &lt;RightImage location=&quot;right.tif&quot;/&gt; . &lt;MyRefFile location=&quot;c:\ug\ref\refname.txt&quot; transferable=&quot;no&quot;/&gt; . &lt;BottomImage location=&quot;bottom.tif&quot;/&gt; &lt;/Views&gt; &lt;/ObjectData&gt; </pre></body>
</html>