WebPart.HelpMode Propriété

  • Référence

Définition

Espace de noms:
System.Web.UI.WebControls.WebParts
Assembly:
System.Web.dll

Obtient ou définit le type d'interface utilisateur utilisé pour afficher le contenu de l'aide pour un contrôle WebPart.

public:
 virtual property System::Web::UI::WebControls::WebParts::WebPartHelpMode HelpMode { System::Web::UI::WebControls::WebParts::WebPartHelpMode get(); void set(System::Web::UI::WebControls::WebParts::WebPartHelpMode value); };
[System.Web.UI.Themeable(false)]
[System.Web.UI.WebControls.WebParts.Personalizable(System.Web.UI.WebControls.WebParts.PersonalizationScope.Shared)]
public virtual System.Web.UI.WebControls.WebParts.WebPartHelpMode HelpMode { get; set; }
[<System.Web.UI.Themeable(false)>]
[<System.Web.UI.WebControls.WebParts.Personalizable(System.Web.UI.WebControls.WebParts.PersonalizationScope.Shared)>]
member this.HelpMode : System.Web.UI.WebControls.WebParts.WebPartHelpMode with get, set
Public Overridable Property HelpMode As WebPartHelpMode

Valeur de propriété

WebPartHelpMode

Une des valeurs de l'objet WebPartHelpMode. La valeur par défaut est Modal.

Attributs
ThemeableAttribute PersonalizableAttribute

Exceptions

ArgumentOutOfRangeException

La valeur spécifiée n'est pas l'une des valeurs WebPartHelpMode.

Exemples

L’exemple de code suivant illustre l’utilisation de la HelpMode propriété pour afficher l’aide d’un contrôle dans la même fenêtre de navigateur. La première partie de cet exemple suppose l’utilisation d’un contrôle personnalisé, TextDisplayWebPartqui se trouve dans la section Exemple de la vue d’ensemble de la WebPart classe.

L’exemple de code inclut également une page HTML qui contient du contenu d’aide fictif pour le TextDisplayWebPart contrôle. Pour que cet exemple fonctionne, vous devez enregistrer le code suivant dans un fichier nommé Textwebparthelp.htm et le placer dans le même répertoire de votre site que la page .aspx.

<html>  
<head runat="server">  
    <title>Text Content WebPart Help</title>  
</head>  
<body>  
  <div>  
  <h1>Text Content WebPart Help</h1>  
  To make the WebPart control work...  
  </div>  
</body>  
</html>

La dernière partie de l’exemple est une page Web qui montre comment référencer le TextDisplayWebPart contrôle. Notez que dans le balisage déclaratif, la HelpMode valeur de la propriété est définie Navigatesur , et le code définit également la valeur de la HelpUrl propriété sur le nom du fichier HTML qui contient le contenu de l’aide. Chargez la page dans un navigateur, puis cliquez sur le verbe d’aide dans le menu verbes du WebPart contrôle.

<%@ page language="C#" %>
<%@ register tagprefix="aspSample" 
             Namespace="Samples.AspNet.CS.Controls" 
             Assembly="TextDisplayWebPartCS" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
  <form id="Form1" runat="server">
    <asp:webpartmanager id="WebPartManager1" runat="server" />
    <asp:webpartzone
      id="WebPartZone1"
      runat="server"
      backcolor="#99cccc">
        <parttitlestyle font-bold="true" forecolor="#ffffff" />
        <partstyle
          borderwidth="1px" 
          borderstyle="Solid" 
          bordercolor="#81AAF2" />
        <zonetemplate>
          <aspSample:TextDisplayWebPart 
            runat="server"   
            id="textwebpart" 
            title = "Text Content WebPart" 
            width="350px" 
            HelpMode="navigate"
            HelpUrl="TextWebPartHelp.htm" />
        </zonetemplate>
    </asp:webpartzone>
  </form>
</body>
</html>

<%@ page language="VB" %>
<%@ register tagprefix="aspSample" 
             Namespace="Samples.AspNet.VB.Controls" 
             Assembly="TextDisplayWebPartVB" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
  <form id="Form1" runat="server">
    <asp:webpartmanager id="WebPartManager1" runat="server" />
    <asp:webpartzone
      id="WebPartZone1"
      runat="server"
      backcolor="#99cccc">
        <parttitlestyle font-bold="true" forecolor="#ffffff" />
        <partstyle
          borderwidth="1px" 
          borderstyle="Solid" 
          bordercolor="#81AAF2" />
        <zonetemplate>
          <aspSample:TextDisplayWebPart 
            runat="server"   
            id="textwebpart" 
            title = "Text Content WebPart" 
            width="350px" 
            HelpMode="navigate"
            HelpUrl="TextWebPartHelp.htm" />
        </zonetemplate>
    </asp:webpartzone>
  </form>
</body>
</html>

Remarques

Utilisez la HelpMode propriété pour déterminer comment un navigateur affiche le contenu d’aide d’un contrôle. Le tableau suivant répertorie les effets des différents modes d’aide sur un navigateur lorsque le contenu d’aide d’un WebPart contrôle est affiché.

Mode d’aide Comportement du navigateur
Modal Ouvre une fenêtre distincte, si le navigateur intègre cette fonctionnalité. Un utilisateur doit fermer la fenêtre avant de rétablir la page WebPart.
Modeless Ouvre une fenêtre distincte, si le navigateur intègre cette fonctionnalité. Un utilisateur ne doit pas fermer la fenêtre avant de rétablir la page Web.
Navigate Remplace la page WebPart dans la fenêtre du navigateur.

Cette propriété ne peut pas être définie par les thèmes ou les thèmes de feuille de style. Pour plus d’informations, consultez ThemeableAttribute et ASP.NET thèmes et peaux.

L’étendue de personnalisation de cette propriété est définie Shared et peut être modifiée uniquement par les utilisateurs autorisés. Pour plus d’informations, consultez PersonalizableAttribute et composants WebPart vue d’ensemble de la personnalisation.

S’applique à

Voir aussi