GenericWebPart.TitleIconImageUrl Proprietà

Definizione

Ottiene o imposta l'URL di un'immagine utilizzata per rappresentare un controllo GenericWebPart nella relativa barra del titolo.Gets or sets the URL to an image used to represent a GenericWebPart control in the control's own title bar.

public:
 virtual property System::String ^ TitleIconImageUrl { System::String ^ get(); void set(System::String ^ value); };
public override string TitleIconImageUrl { get; set; }
member this.TitleIconImageUrl : string with get, set
Public Overrides Property TitleIconImageUrl As String

Valore della proprietà

Un stringa che rappresenta l'URL di un'immagine.A string that represents the URL to an image. Il valore predefinito è una stringa vuota ("").The default value is an empty string ("").

Esempi

Nell'esempio di codice riportato di seguito viene illustrato l' TitleIconImageUrl utilizzo dichiarativo e programmatico della proprietà.The following code example demonstrates declarative and programmatic use of the TitleIconImageUrl property. Il codice sorgente completo per l'esempio è disponibile nella sezione esempio dell' GenericWebPart argomento introduttivo.The complete source code for the example is found in the Example section of the GenericWebPart overview topic.

Nella prima parte dell'esempio di codice viene illustrato il TitleIconImageUrl modo in cui la proprietà viene impostata in modo dichiarativo in un controllo server all'interno di un WebPartZone controllo.The first part of the code example shows how the TitleIconImageUrl property is set declaratively on a server control within a WebPartZone control.

<asp:WebPartZone ID="WebPartZone1" runat="server">
  <ZoneTemplate>
    <asp:Calendar ID="Calendar1" runat="server"
      Title="My Calendar"
      Description="A calendar used as a GenericWebPart control."
      CatalogIconImageUrl="MyCatalogIcon.gif"
      TitleIconimageUrl ="MyTitleIcon.gif"
      TitleUrl="MyInfoUrl.htm" 
      Width="250"/>
  </ZoneTemplate>
</asp:WebPartZone>
<asp:WebPartZone ID="WebPartZone1" runat="server">
  <ZoneTemplate>
    <asp:Calendar ID="Calendar1" runat="server"
      Title="My Calendar"
      Description="A calendar used as a GenericWebPart control."
      CatalogIconImageUrl="MyCatalogIcon.gif"
      TitleIconimageUrl ="MyTitleIcon.gif"
      TitleUrl="MyInfoUrl.htm" 
      Width="250"/>
  </ZoneTemplate>
</asp:WebPartZone>

Nella seconda parte dell'esempio di codice viene illustrato come accedere alla proprietà a livello di programmazione per visualizzare il relativo valore in un'etichetta.The second part of the code example demonstrates how to access the property programmatically to display its value in a label.

protected void Button1_Click(object sender, EventArgs e)
{

  Label2.Text =
    @"<h3>Calendar GenericWebPart Properties</h3>" +
    "<em>Title: </em>" + calendarPart.Title +
    "<br />" +
    "<em>CatalogIconImageUrl:  </em>" + calendarPart.CatalogIconImageUrl +
    "<br />" +
    "<em>TitleUrl: </em>" + calendarPart.TitleUrl +
    "<br />" +
    "<em>Decription: </em>" + calendarPart.Description +
    "<br />" +
    "<em>TitleIconImageUrl: </em>" + calendarPart.TitleIconImageUrl +
    "<br />" +
    "<em>ChildControl ID: </em>" + calendarPart.ChildControl.ID +
    "<br />" +
    "<em>ChildControl Type: </em>" + calendarPart.ChildControl.GetType().Name +
    "<br />" +
    "<em>GenericWebPart ID: </em>" + calendarPart.ID +
    "<br />" +
    "<em>GenericWebPart Type: </em>" + calendarPart.GetType().Name +
    "<br />" +
    "<em>GenericWebPart Parent ID: </em>" + calendarPart.Parent.ID;

  Label3.Text =
    @"<h3>BulletedList GenericWebPart Properties</h3>" +
    "<em>Title: </em>" + listPart.Title +
    "<br />" +
    "<em>CatalogIconImageUrl:  </em>" + listPart.CatalogIconImageUrl +
    "<br />" +
    "<em>TitleUrl: </em>" + listPart.TitleUrl +
    "<br />" +
    "<em>Decription: </em>" + listPart.Description +
    "<br />" +
    "<em>TitleIconImageUrl: </em>" + listPart.TitleIconImageUrl +
    "<br />" +
    "<em>ChildControl ID: </em>" + listPart.ChildControl.ID +
    "<br />" +
    "<em>ChildControl Type: </em>" + listPart.ChildControl.GetType().Name +
    "<br />" +
    "<em>GenericWebPart ID: </em>" + listPart.ID +
    "<br />" +
    "<em>GenericWebPart Type: </em>" + listPart.GetType().Name +
    "<br />" +
    "<em>GenericWebPart Parent ID: </em>" + listPart.Parent.ID;
}
  Protected Sub Button1_Click(ByVal sender As Object, ByVal e As EventArgs)

    Label2.Text = _
      "<h3>Calendar GenericWebPart Properties</h3>" & _
      "<em>Title: </em>" & calendarPart.Title & _
      "<br />" & _
      "<em>CatalogIconImageUrl:  </em>" & calendarPart.CatalogIconImageUrl & _
      "<br />" & _
      "<em>TitleUrl: </em>" & calendarPart.TitleUrl & _
      "<br />" & _
      "<em>Decription: </em>" & calendarPart.Description & _
      "<br />" & _
      "<em>TitleIconImageUrl: </em>" & calendarPart.TitleIconImageUrl & _
      "<br />" & _
      "<em>ChildControl ID: </em>" & calendarPart.ChildControl.ID & _
      "<br />" & _
      "<em>ChildControl Type: </em>" & calendarPart.ChildControl.GetType().Name & _
      "<br />" & _
      "<em>GenericWebPart ID: </em>" & calendarPart.ID & _
      "<br />" & _
      "<em>GenericWebPart Type: </em>" & calendarPart.GetType().Name & _
      "<br />" & _
      "<em>GenericWebPart Parent ID: </em>" & calendarPart.Parent.ID

    Label3.Text = _
      "<h3>BulletedList GenericWebPart Properties</h3>" & _
      "<em>Title: </em>" & listPart.Title & _
      "<br />" & _
      "<em>CatalogIconImageUrl:  </em>" & listPart.CatalogIconImageUrl & _
      "<br />" & _
      "<em>TitleUrl: </em>" & listPart.TitleUrl & _
      "<br />" & _
      "<em>Decription: </em>" & listPart.Description & _
      "<br />" & _
      "<em>TitleIconImageUrl: </em>" & listPart.TitleIconImageUrl & _
      "<br />" & _
      "<em>ChildControl ID: </em>" & listPart.ChildControl.ID & _
      "<br />" & _
      "<em>ChildControl Type: </em>" & listPart.ChildControl.GetType().Name & _
      "<br />" & _
      "<em>GenericWebPart ID: </em>" & listPart.ID & _
      "<br />" & _
      "<em>GenericWebPart Type: </em>" & listPart.GetType().Name & _
      "<br />" & _
      "<em>GenericWebPart Parent ID: </em>" & listPart.Parent.ID
  End Sub

End Class

Commenti

La TitleIconImageUrl proprietà fornisce un modo per associare un'icona a un GenericWebPart controllo.The TitleIconImageUrl property provides a way to associate an icon with a GenericWebPart control. L'icona viene visualizzata nella barra del titolo del controllo.The icon appears in the control's own title bar. Per coerenza tematica, gli sviluppatori di applicazioni spesso rendono questa icona simile all'immagine che rappresenta il controllo in un catalogo di controlli Web part (l'immagine a cui CatalogIconImageUrl viene fatto riferimento nella proprietà).For thematic consistency, application developers often make this icon similar to the image that represents the control in a catalog of Web Parts controls (the image referenced in the CatalogIconImageUrl property).

Poiché viene implementato nel set di controlli di Web part, la TitleIconImageUrl proprietà può essere personalizzata dagli utenti finali per modificare l'immagine o l'icona visualizzata nella barra del titolo di un controllo.As it is implemented in the Web Parts control set, the TitleIconImageUrl property can be personalized by end users to change the image or icon that appears in a control's title bar.

Questa proprietà esegue l'override della proprietà di base in modo che sia possibile accedere alla proprietà nel controllo figlio come se fosse WebPart un controllo true.This property overrides the base property so that you can access the property on the child control as if it were a true WebPart control.

È possibile impostare i valori per la proprietà nel controllo nel markup dichiarativo di una pagina Web, oltre che a livello di codice.You can set values for the property on your control in the declarative markup of a Web page, as well as programmatically. Per fornire un valore predefinito per la proprietà ogni volta che viene usato il controllo, è possibile IWebPart implementare l'interfaccia.To provide a default value for the property whenever the control is used, you can implement the IWebPart interface.

Si applica a

Vedi anche