<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<link href="mmres://user_interface_reference.css" rel="stylesheet" type="text/css">
<title>CFTABLE</title>
</head>
<body bgcolor="#FFFFFF" text="#000000">
   <div id="説明">
   <table cellpadding="0" cellspacing="0" border="0" width="100%" class="main">
      <tr> 
         <td valign="top" class="name">CFTABLE</td>
         <td valign="top" nowrap class="compatibility">&nbsp;</td>
      </tr>
      <tr>
         <td colspan="2" class="divider"><img src="dwres:18084" width="100%" height="1"></td>
      </tr>


    </td>
  </tr>
  <tr>
    <td valign="top" colspan="2" class="description"><span class="title">説明</span>
<p>
ColdFusion ページ内にテーブルを構築します。cftable タグでは、書式付きテキストとして、または、HTMLTable 属性を使用して、HTML テーブルにデータを表示します。HTML の table タグコードを記述したくない場合や、書式付きテキストとしてデータを表示できる場合に、このタグを使用します。 
</p>

<p>
HTML で &lt;pre&gt; タグおよび &lt;/pre&gt; タグを使用して定義された、書式付きテキストは、固定幅のフォントで表示されます。空白および改行は、pre タグ内の記述に従って表示されます。詳細については、HTML のリファレンスガイドを参照してください。
</p>

<p>
テーブルの列および行の仕様を定義するには、このタグ内でcfcolタグを使用します。
</p>
    </td>
  </tr>
  <tr>
    <td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
  </tr>
  <tr>
    <td valign="top" colspan="2" class="description"><span class="title">カテゴリ</span>
<p>
データ出力タグ
</p>
  <tr>
    <td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
  </tr>
  <tr>
    <td valign="top" colspan="2" class="syntax"><span class="title">シンタックス</span><pre>&lt;cftable
   query = &quot;query_name&quot;
   maxRows = &quot;maxrows_table&quot;
   colSpacing = &quot;number_of_spaces&quot;
   headerLines = &quot;number_of_lines&quot;
   HTMLTable
   border
   colHeaders
   startRow = &quot;row_number&quot;&gt;
   ...
&lt;/cftable&gt;
</pre>    </td>
  </tr>
  <tr>
    <td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
  </tr>
  <tr>
    <td valign="top" colspan="2" class="description"><span class="title">関連項目</span>
<p>
cfcol、cfcontent、cflog、cfoutput、cfprocessingdirective、cftable、『ColdFusion MX 開発ガイド』の第20章の「データへのアクセスおよび取り出し」 の「データの取り出し」
</p>

<p>

</p>
    </td>
  </tr>
  <tr>
    <td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
  </tr>
  <tr>
    <td valign="top" colspan="2" class="description"><span class="title">使用方法</span>
<p>
このタグでは、テーブルデータの配置、列幅の設定、および列のヘッダの定義が行われます。 
</p>

<p>
このタグには、少なくとも 1 つの cfcol タグが必要です。また、cfcol タグおよび cftable タグはページ内で隣接させて配置する必要があります。このタグ内には、cfcol タグだけをネストできます。cftable タグはネストできません。
</p>

<p>
cfcol の header で指定されるテキストを表示するには、cfcol の header 属性と cftable の colHeader 属性を指定する必要があります。どちらか一方の属性だけを指定しても、ヘッダは表示されず、エラーも発生しません。
</p>
    </td>
  </tr>
  <tr>
    <td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
  </tr>
  <tr>
    <td valign="top" colspan="2" class="description"><span class="title">例</span><pre>&lt;!--- この例では、cfcol タグと cftable タグを使用して、クエリーから返された情報の位置を揃えます。 ---&gt;
&lt;!--- このクエリーでは、cfdocexamples データソースから従業員情報を選択します。 ---&gt;
&lt;cfquery name = &quot;GetEmployees&quot; dataSource = &quot;cfdocexamples&quot;&gt;
   SELECT  Emp_ID, FirstName, LastName, EMail, Phone, Department
   FROM Employees
&lt;/cfquery&gt;

&lt;html&gt;
&lt;body&gt;
&lt;h3&gt;cftable の例&lt;/h3&gt;

&lt;!--- HTMLTable 属性を使用して、PRE 書式の情報としてではなく、 HTML テーブルとして cftable を表示して
いることに注意してください。 ---&gt;
&lt;cftable query = &quot;GetEmployees&quot;
   startRow = &quot;1&quot; colSpacing = &quot;3&quot; HTMLTable&gt;
&lt;!--- 各 cfcol タグでテーブル内の列の幅を設定し、セルに挿入するヘッダ情報、およびテキストまたは CFML を
指定します。 ---&gt;
   &lt;cfcol header = &quot;&lt;b&gt;ID&lt;/b&gt;&quot;
      align = &quot;Left&quot;
      width = 2
      text  = &quot;#Emp_ID#&quot;&gt;
      
   &lt;cfcol header = &quot;&lt;b&gt;名前と電子メール&lt;/b&gt;&quot;   
      align = &quot;Left&quot;
      width = 15
      text  = &quot;&lt;a href = ﾕmailto:#Email#ﾕ&gt;#FirstName# #LastName#&lt;/A&gt;&quot;&gt;

   &lt;cfcol header = &quot;&lt;b&gt;電話番号&lt;/b&gt;&quot;
      align = &quot;Center&quot;
      width = 15
      text  = &quot;#Phone#&quot;&gt;
&lt;/cftable&gt;
&lt;/body&gt;
&lt;/html&gt;
</pre>
         </td>
      </tr>
   </table>
   </div>
<div id="QUERY">
<table border="0" cellspacing="0" cellpadding="0" width="100%">
<tr>  
<td valign="top" class="name">QUERY</td>
  <td valign="top" nowrap class="compatibility">&nbsp;</td>
  </tr>
  <tr>
  <td colspan="2" class="divider"><img src="dwres:18084" width="100%" height="1"></td>
  </tr>

  <tr>
  <td valign="top" class="syntax">&nbsp;</td>
  <td valign="top" nowrap class="requirements">必須</td>
  </tr>
  <tr>
  <td colspan="2" class="clearseparation">&nbsp;</td>
  </tr>
  <tr>
  <td valign="top" colspan="2" class="description">



<p>データを取り出す cfquery の名前です。</p>

  </td>
  </tr>
  </table>
</div>
<div id="MAXROWS">
<table border="0" cellspacing="0" cellpadding="0" width="100%">
<tr>  
<td valign="top" class="name">MAXROWS</td>
  <td valign="top" nowrap class="compatibility">&nbsp;</td>
  </tr>
  <tr>
  <td colspan="2" class="divider"><img src="dwres:18084" width="100%" height="1"></td>
  </tr>

  <tr>
  <td valign="top" class="syntax">&nbsp;</td>
  <td valign="top" nowrap class="requirements">オプション</td>
  </tr>
  <tr>
  <td colspan="2" class="clearseparation">&nbsp;</td>
  </tr>
  <tr>
  <td valign="top" colspan="2" class="description">



<p>テーブルに表示する行の最大数です。</p>

  </td>
  </tr>
  </table>
</div>
<div id="COLSPACING">
<table border="0" cellspacing="0" cellpadding="0" width="100%">
<tr>  
<td valign="top" class="name">COLSPACING</td>
  <td valign="top" nowrap class="compatibility">&nbsp;</td>
  </tr>
  <tr>
  <td colspan="2" class="divider"><img src="dwres:18084" width="100%" height="1"></td>
  </tr>

  <tr>
  <td valign="top" class="syntax">&nbsp;</td>
  <td valign="top" nowrap class="requirements">オプション</td>
  </tr>
  <tr>
  <td colspan="2" class="clearseparation">&nbsp;</td>
  </tr>
  <tr>
  <td valign="top" colspan="2" class="description">

<strong>Default value:</strong> "2"


<p>列間のスペースの数です。 </p>

  </td>
  </tr>
  </table>
</div>
<div id="HEADERLINES">
<table border="0" cellspacing="0" cellpadding="0" width="100%">
<tr>  
<td valign="top" class="name">HEADERLINES</td>
  <td valign="top" nowrap class="compatibility">&nbsp;</td>
  </tr>
  <tr>
  <td colspan="2" class="divider"><img src="dwres:18084" width="100%" height="1"></td>
  </tr>

  <tr>
  <td valign="top" class="syntax">&nbsp;</td>
  <td valign="top" nowrap class="requirements">オプション</td>
  </tr>
  <tr>
  <td colspan="2" class="clearseparation">&nbsp;</td>
  </tr>
  <tr>
  <td valign="top" colspan="2" class="description">

<strong>Default value:</strong> "2"


<p>テーブルのヘッダに使用する線の数です (デフォルトでは、テーブルのヘッダと最初の行の間を 1 行空けます)。</p>

  </td>
  </tr>
  </table>
</div>
<div id="HTMLTABLE">
<table border="0" cellspacing="0" cellpadding="0" width="100%">
<tr>  
<td valign="top" class="name">HTMLTABLE</td>
  <td valign="top" nowrap class="compatibility">&nbsp;</td>
  </tr>
  <tr>
  <td colspan="2" class="divider"><img src="dwres:18084" width="100%" height="1"></td>
  </tr>

  <tr>
  <td valign="top" class="syntax">&nbsp;</td>
  <td valign="top" nowrap class="requirements">オプション</td>
  </tr>
  <tr>
  <td colspan="2" class="clearseparation">&nbsp;</td>
  </tr>
  <tr>
  <td valign="top" colspan="2" class="description">



<p>HTML 3.0 テーブルでデータを表示します。</p>
<p>値にかかわらず、この属性を使用すると、データが HTML テーブルで表示されます。 </p>

  </td>
  </tr>
  </table>
</div>
<div id="BORDER">
<table border="0" cellspacing="0" cellpadding="0" width="100%">
<tr>  
<td valign="top" class="name">BORDER</td>
  <td valign="top" nowrap class="compatibility">&nbsp;</td>
  </tr>
  <tr>
  <td colspan="2" class="divider"><img src="dwres:18084" width="100%" height="1"></td>
  </tr>

  <tr>
  <td valign="top" class="syntax">&nbsp;</td>
  <td valign="top" nowrap class="requirements">オプション</td>
  </tr>
  <tr>
  <td colspan="2" class="clearseparation">&nbsp;</td>
  </tr>
  <tr>
  <td valign="top" colspan="2" class="description">



<p>テーブルの周囲に枠を表示します。 </p>
<p>値にかかわらず、この属性を使用するとテーブルの周囲に枠が表示されます。</p>
<p>HTMLTable 属性を使用する場合のみ使用します。</p>

  </td>
  </tr>
  </table>
</div>
<div id="COLHEADERS">
<table border="0" cellspacing="0" cellpadding="0" width="100%">
<tr>  
<td valign="top" class="name">COLHEADERS</td>
  <td valign="top" nowrap class="compatibility">&nbsp;</td>
  </tr>
  <tr>
  <td colspan="2" class="divider"><img src="dwres:18084" width="100%" height="1"></td>
  </tr>

  <tr>
  <td valign="top" class="syntax">&nbsp;</td>
  <td valign="top" nowrap class="requirements">オプション</td>
  </tr>
  <tr>
  <td colspan="2" class="clearseparation">&nbsp;</td>
  </tr>
  <tr>
  <td valign="top" colspan="2" class="description">



<p>列のヘッダを表示します。この属性を使用する場合、cfcol タグの header 属性を同時に使用してヘッダを定義する必要があります。 </p>
<p>値にかかわらず、この属性を使用すると列のヘッダが表示されます。 </p>

  </td>
  </tr>
  </table>
</div>
<div id="STARTROW">
<table border="0" cellspacing="0" cellpadding="0" width="100%">
<tr>  
<td valign="top" class="name">STARTROW</td>
  <td valign="top" nowrap class="compatibility">&nbsp;</td>
  </tr>
  <tr>
  <td colspan="2" class="divider"><img src="dwres:18084" width="100%" height="1"></td>
  </tr>

  <tr>
  <td valign="top" class="syntax">&nbsp;</td>
  <td valign="top" nowrap class="requirements">オプション</td>
  </tr>
  <tr>
  <td colspan="2" class="clearseparation">&nbsp;</td>
  </tr>
  <tr>
  <td valign="top" colspan="2" class="description">

<strong>Default value:</strong> "1"


<p>テーブルの 1 行目に配置するクエリー結果の行です。 </p>

  </td>
  </tr>
  </table>
</div>

  </body>
</html>
