IWebPart.TitleIconImageUrl プロパティ
アセンブリ: System.Web (system.web.dll 内)
構文Dim instance As IWebPart Dim value As String value = instance.TitleIconImageUrl instance.TitleIconImageUrl = value
/** @property */ String get_TitleIconImageUrl () /** @property */ void set_TitleIconImageUrl (String value)
イメージへの URL を表す文字列。既定値は空の文字列 ("") です。
解説TitleIconImageUrl プロパティによって、アイコンが WebPart コントロールに関連付けられます。アイコンは、コントロール自体のタイトル バーに表示されます。テーマの一貫性を保つために、アプリケーション開発者は、このアイコンを Web パーツ コントロールのカタログ内でコントロールを表しているイメージ (CatalogIconImageUrl プロパティで参照されるイメージ) と似たものにする場合があります。
Web パーツ コントロール セットに実装されているため、TitleIconImageUrl プロパティは、エンド ユーザーがコントロールのタイトル バーに表示されるイメージまたはアイコンを変更することによってパーソナル化できます。
使用例TitleIconImageUrl プロパティを、宣言で使用する方法およびプログラムで使用する方法を示すコード例を次に示します。この例の完全なソース コードは、IWebPart の概要にある「例」のセクションを参照してください。
コード例の最初の部分は、ユーザー コントロールにおける TitleIconImageUrl プロパティの実装方法を示しています。
Public Property TitleIconImageUrl() As String _ Implements IWebPart.TitleIconImageUrl Get Dim objTitle As Object = ViewState("TitleIconImageUrl") If objTitle Is Nothing Then Return String.Empty End If Return CStr(objTitle) End Get Set(ByVal value As String) ViewState("TitleIconImageUrl") = value End Set End Property
public string TitleIconImageUrl { get { object objTitle = ViewState["TitleIconImageUrl"]; if (objTitle == null) return String.Empty; return (string)objTitle; } set { ViewState["TitleIconImageUrl"] = value; } }
コード例の 2 番目の部分は、ユーザー コントロールにおけるメソッドの使用を示しています。ユーザーがページ上のオプション ボタンから適切なプロパティ名を選択し、テキスト ボックスに新しい値を入力して [更新] ボタンをクリックすると、TitleIconImageUrl プロパティの値がプログラムから設定されます。
' Update the selected IWebPart property value. Sub Button1_Click(ByVal sender As Object, ByVal e As EventArgs) Dim propertyValue As String = Server.HtmlEncode(TextBox3.Text) TextBox3.Text = String.Empty Select Case RadioButtonList1.SelectedValue Case "title" Me.Title = propertyValue Case "description" Me.Description = propertyValue Case "catalogiconimageurl" Me.CatalogIconImageUrl = propertyValue Case "titleiconimageurl" Me.TitleIconImageUrl = propertyValue Case "titleurl" Me.TitleUrl = propertyValue Case Else End Select End Sub 'Button1_Click
// Update the selected IWebPart property value. void Button1_Click(object sender, EventArgs e) { String propertyValue = Server.HtmlEncode(TextBox3.Text); TextBox3.Text = String.Empty; switch (RadioButtonList1.SelectedValue) { case "title": this.Title = propertyValue; break; case "description": this.Description = propertyValue; break; case "catalogiconimageurl": this.CatalogIconImageUrl = propertyValue; break; case "titleiconimageurl": this.TitleIconImageUrl = propertyValue; break; case "titleurl": this.TitleUrl = propertyValue; break; default: break; } }
コード例の 3 番目の部分は、IWebPart インターフェイスを実装するユーザー コントロールを WebPartZone コントロールから参照する方法と、コントロールに対して TitleIconImageUrl プロパティを宣言によって設定する方法を示しています。実際のイメージへの URL を指定しない場合は、アイコンのプレースホルダがタイトル バーに表示されます。
<%@ page language="VB" %> <%@ register tagprefix="uc1" tagname="AccountUserControlVB" src="AccountUserControlvb.ascx"%> <html> <head runat="server"> <title> Personalizable User Control with IWebPart Properties </title> </head> <body> <form id="form1" runat="server"> <asp:webpartmanager id="WebPartManager1" runat="server" /> <asp:webpartzone id="zone1" runat="server" headertext="Main" CloseVerb-Enabled="false"> <zonetemplate> <uc1:AccountUserControlVB runat="server" id="accountwebpart" title="Account Form" Description="Account Form with default values." CatalogIconImageUrl="MyCatalogIcon.gif" TitleIconImageUrl="MyTitleIcon.gif" TitleUrl="MyUrl.html"/> </zonetemplate> </asp:webpartzone> </form> </body> </html>
<%@ page language="c#" %> <%@ register tagprefix="uc1" tagname="AccountUserControlCS" src="AccountUserControlcs.ascx"%> <html> <head runat="server"> <title> Personalizable User Control with IWebPart Properties </title> </head> <body> <form id="form1" runat="server"> <asp:webpartmanager id="WebPartManager1" runat="server" /> <asp:webpartzone id="zone1" runat="server" headertext="Main" CloseVerb-Enabled="false"> <zonetemplate> <uc1:AccountUserControlCS runat="server" id="accountwebpart" title="Account Form" Description="Account Form with default values." CatalogIconImageUrl="MyCatalogIcon.gif" TitleIconImageUrl="MyTitleIcon.gif" TitleUrl="MyUrl.html"/> </zonetemplate> </asp:webpartzone> </form> </body> </html>
プラットフォームWindows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。
バージョン情報参照Weblioに収録されているすべての辞書からIWebPart.TitleIconImageUrl プロパティを検索する場合は、下記のリンクをクリックしてください。
全ての辞書からIWebPart.TitleIconImageUrl プロパティ
を検索
- IWebPart.TitleIconImageUrl プロパティのページへのリンク
