ImageButton クラス
アセンブリ: System.Web (system.web.dll 内)
構文Public Class ImageButton Inherits Image Implements IPostBackDataHandler, IPostBackEventHandler, IButtonControl
public ref class ImageButton : public Image, IPostBackDataHandler, IPostBackEventHandler, IButtonControl
解説ImageButton コントロールを使用して、マウス クリックに応答するイメージを表示します。
ImageButton コントロールがクリックされると、Click イベントと Command イベントの両方が発生します。
OnClick イベント ハンドラを使用することにより、イメージがクリックされた位置の座標をプログラムによって確認できます。その後、座標の値に基づいて、応答をコード化できます。原点 (0, 0) は、イメージの左上隅です。
OnCommand イベント ハンドラを使用して、ImageButton コントロールがコマンド ボタンのような動作をするように設定できます。CommandName プロパティを使用して、コマンド名をコントロールに関連付けることができます。これにより、複数の ImageButton コントロールを同一の Web ページ上に配置できます。さらに、CommandName プロパティの値を OnCommand イベント ハンドラでプログラムにより識別して、各 ImageButton コントロールがクリックされたときに実行する適切なアクションを決定できます。CommandArgument プロパティを使用して、昇順の指定など、コマンドについての追加情報を渡すこともできます。
既定では、ImageButton コントロールがクリックされたときにページ検証を実行します。ページ検証は、ページ上にある検証コントロールに関連付けられたすべての入力コントロールが、その検証コントロールによって指定されている検証規則に準拠しているかどうかを判断します。ページ検証を実行しないようにするには、CausesValidation プロパティを false に設定します。
ユーザー補助このコントロールに既定でレンダリングされるマークアップは、Web Content Accessibility Guidelines (WCAG) 1.0 の優先度 1 ガイドラインなどのユーザー補助に関する標準に適合しない可能性があります。このコントロールのユーザー補助サポートの詳細については、「ASP.NET コントロールとユーザー補助」を参照してください。
使用例イメージがクリックされた位置の座標を表示する ImageButton コントロールを作成する方法のコード例を次に示します。
.gif) メモ |
|---|
| 次のコード サンプルはシングルファイル コード モデルを使用しており、分離コード ファイルに直接コピーされた場合は正常に動作しない可能性があります。このコード サンプルは、拡張子が .aspx の空のテキスト ファイルにコピーする必要があります。Web フォームのコード モデルの詳細については、「ASP.NET Web ページのコード モデル」を参照してください。 |
<%@ Page Language="VB" AutoEventWireup="True" %> <html> <head> <script language="VB" runat="server"> Sub ImageButton_Click(sender As Object, e As ImageClickEventArgs) Label1.Text = "You clicked the ImageButton control at the coordinates: (" & _ e.X.ToString() & ", " & e.Y.ToString() & ")" End Sub </script> </head> <body> <form runat="server"> <h3>ImageButton Sample</h3> Click anywhere on the image.<br><br> <asp:ImageButton id="imagebutton1" runat="server" AlternateText="ImageButton 1" ImageAlign="left" ImageUrl="images/pict.jpg" OnClick="ImageButton_Click"/> <br><br> <asp:label id="Label1" runat="server"/> </form> </body> </html>
<%@ Page Language="C#" AutoEventWireup="True" %> <html> <head> <script language="C#" runat="server"> void ImageButton_Click(object sender, ImageClickEventArgs e) { Label1.Text = "You clicked the ImageButton control at the coordinates: (" + e.X.ToString() + ", " + e.Y.ToString() + ")"; } </script> </head> <body> <form runat="server"> <h3>ImageButton Sample</h3> Click anywhere on the image.<br><br> <asp:ImageButton id="imagebutton1" runat="server" AlternateText="ImageButton 1" ImageAlign="left" ImageUrl="images/pict.jpg" OnClick="ImageButton_Click"/> <br><br> <asp:label id="Label1" runat="server"/> </form> </body> </html>
<%@ Page Language="JScript" AutoEventWireup="True" %> <html> <head> <script language="JSCRIPT" runat="server"> function ImageButton_Click(sender : Object, e : ImageClickEventArgs) { Label1.Text = "You clicked the ImageButton control at the coordinates: (" + e.X.ToString() + ", " + e.Y.ToString() + ")" } </script> </head> <body> <form runat="server"> <h3>ImageButton Sample</h3> Click anywhere on the image.<br><br> <asp:ImageButton id="imagebutton1" runat="server" AlternateText="ImageButton 1" ImageAlign="left" ImageUrl="images/pict.jpg" OnClick="ImageButton_Click"/> <br><br> <asp:label id="Label1" runat="server"/> </form> </body> </html>
.NET Framework のセキュリティ継承階層System.Web.UI.Control
System.Web.UI.WebControls.WebControl
System.Web.UI.WebControls.Image
System.Web.UI.WebControls.ImageButton
スレッド セーフプラットフォーム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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。
バージョン情報参照Weblioに収録されているすべての辞書からImageButton クラスを検索する場合は、下記のリンクをクリックしてください。
全ての辞書からImageButton クラス
を検索
- ImageButton クラスのページへのリンク
