TableCaptionAlign

.NET Framework クラス ライブラリ リファレンス

Table.CaptionAlign プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

Table コントロールの HTML キャプション要素の水平位置または垂直位置を取得または設定します。このプロパティは、補助技術デバイスのユーザーにとって、より使いやすいコントロールを実現するための手段として用意されています。

名前空間: System.Web.UI.WebControls
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Public Overridable Property
 CaptionAlign As TableCaptionAlign

Visual Basic (使用法)

Dim instance As Table
Dim value As TableCaptionAlign

value = instance.CaptionAlign

instance.CaptionAlign = value

C#

public virtual TableCaptionAlign CaptionAlign { get;
 set; }

C++

public:
virtual property TableCaptionAlign CaptionAlign {
    TableCaptionAlign get ();
    void set (TableCaptionAlign value);
}

J#

/** @property */
public TableCaptionAlign get_CaptionAlign ()

/** @property */
public void set_CaptionAlign (TableCaptionAlign
 value)

JScript

public function get CaptionAlign
 () : TableCaptionAlign

public function set CaptionAlign
 (value : TableCaptionAlign)

プロパティ値
TableCaptionAlign 列挙値の 1 つ。既定値は NotSet です。

例外

例外の種類	条件
ArgumentOutOfRangeException	指定した型が TableCaptionAlign 列挙値ではありません。

解説

CaptionAlign プロパティを使用して、Table コントロールの HTML キャプション要素の水平位置または垂直位置を指定します。このプロパティは、補助技術デバイスのユーザーにとって、より使いやすいコントロールを実現するための手段として用意されています。

このプロパティは、TableCaptionAlign 列挙値の 1 つを使用して設定します。有効値の一覧を次の表に示します。

値	説明
NotSet	キャプション要素の配置が設定されていません。
Top	キャプション要素は、テーブルの上部に揃えて配置されます。
Bottom	キャプション要素は、テーブルの下部に揃えて配置されます。
Left	キャプション要素は、テーブルの左に揃えて配置されます。
Right	キャプション要素は、テーブルの右に揃えて配置されます。

Caption プロパティによって、Table コントロールにユーザー補助サポートが追加されます。Table コントロールの HTML キャプション要素に表示するテキストを指定するには、Caption プロパティを使用します。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
Table クラス
Table メンバ
System.Web.UI.WebControls 名前空間
Table.Caption プロパティ
その他の技術情報
Table、TableRow、TableCell の各 Web サーバー コントロール

TableCaptionAlign 列挙体

メモ : この列挙体は、.NET Framework version 2.0 で新しく追加されたものです。

HTML のキャプション要素として表示するテキストの水平方向または垂直方向の配置を指定します。

名前空間: System.Web.UI.WebControls
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Public Enumeration TableCaptionAlign

Visual Basic (使用法)

Dim instance As TableCaptionAlign

C#

public enum TableCaptionAlign

C++

public enum class TableCaptionAlign

J#

public enum TableCaptionAlign

JScript

public enum TableCaptionAlign

メンバ

	メンバ名	説明
	Bottom	キャプション要素は、テーブルの下部に揃えて配置されます。
	Left	キャプション要素は、テーブルの左側に揃えて配置されます。
	NotSet	キャプションの配置が設定されていません。キャプションを表示するブラウザによってキャプションの配置が決定されます。
	Right	キャプション要素は、テーブルの右側に揃えて配置されます。
	Top	キャプション要素は、テーブルの上部に揃えて配置されます。

解説

TableCaptionAlign 列挙体は、Table、GridView、DetailsView、Calendar など、テーブルとして表示できるコントロールに含まれる HTML キャプション要素の水平方向または垂直方向の配置を表します。たとえば、CaptionAlign プロパティでは、これらの列挙値を使用して、Table コントロールのキャプション配置を設定します。

NotSet を指定した場合、そのコントロールを表示するブラウザによってキャプションの配置が決定されます。

CaptionAlign プロパティは、テーブルとして表示できるコントロールに対してキャプション要素の位置を指定します。Caption プロパティは、キャプション要素に表示するテキストを指定します。補助技術デバイスでは、Caption プロパティによって提供される説明を使用して、コントロールのアクセシビリティを高めることができます。たとえば、スクリーン リーダーでは、キャプションを読み上げることにより、テーブルの説明をユーザーに提供できます。

使用例

TableCaptionAlign 列挙体を使用して、Table コントロールの CaptionAlign プロパティを設定する方法を次の例に示します。Table コントロールには、都市 (City) と郵便番号 (ZIP Code) の値を表示する TableRow オブジェクトが含まれています。

Visual Basic

<%@ page language="VB" %>

<script runat="server">

</script>

<html>
  <head id="Head1" runat="server">
      <title>TableCaptionAlign Example</title>
  </head>
  <body>
    <form runat="server">
    <h3>TableCaptionAlign Enumeration Example</h3>
      <asp:table id="Table1" 
        runat="server" 
        caption="ZIP Code and City Mapping" 
        captionalign="Left" 
        gridlines="Both">
        <asp:TableRow id="TableRow1" 
          runat="server">
          <asp:TableCell id="TableCell1" 
            runat="server">
            City Name
          </asp:TableCell>
          <asp:TableCell id="TableCell2" 
            runat="server">
            ZIP Code
          </asp:TableCell>
        </asp:TableRow>
        <asp:TableRow id="TableRow2" 
          runat="server">
          <asp:TableCell id="TableCell3" 
            runat="server">
            Redmond
          </asp:TableCell>
          <asp:TableCell id="TableCell4" 
            runat="server">
            98052
          </asp:TableCell>
        </asp:TableRow>
        <asp:TableRow id="TableRow3" 
          runat="server">
          <asp:TableCell id="TableCell5" 
            runat="server">
            Albany
          </asp:TableCell>
          <asp:TableCell id="TableCell6" 
            runat="server">
            12222
          </asp:TableCell>
        </asp:TableRow>
      </asp:table>
    </form>
  </body>
</html>

C#

<%@ page language="C#" %>

<script runat="server">

</script>

<html>
  <head id="Head1" runat="server">
      <title>TableCaptionAlign Example</title>
  </head>
  <body>
    <form id="Form1" runat="server">
    <h3>TableCaptionAlign Enumeration Example</h3>
      <asp:table id="Table1" 
        runat="server" 
        caption="ZIP Code and City Mapping" 
        captionalign="Left" 
        gridlines="Both">
        <asp:TableRow id="TableRow1" 
          runat="server">
          <asp:TableCell id="TableCell1" 
            runat="server">
            City Name
          </asp:TableCell>
          <asp:TableCell id="TableCell2" 
            runat="server">
            ZIP Code
          </asp:TableCell>
        </asp:TableRow>
        <asp:TableRow id="TableRow2" 
          runat="server">
          <asp:TableCell id="TableCell3" 
            runat="server">
            Redmond
          </asp:TableCell>
          <asp:TableCell id="TableCell4" 
            runat="server">
            98052
          </asp:TableCell>
        </asp:TableRow>
        <asp:TableRow id="TableRow3" 
          runat="server">
          <asp:TableCell id="TableCell5" 
            runat="server">
            Albany
          </asp:TableCell>
          <asp:TableCell id="TableCell6" 
            runat="server">
            12222
          </asp:TableCell>
        </asp:TableRow>
      </asp:table>
    </form>
  </body>
</html>

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
System.Web.UI.WebControls 名前空間
TableCaptionAlign 列挙体
Table クラス
GridView クラス
Calendar クラス
DetailsView クラス