Udostępnij za pośrednictwem

WebPart.HelpMode Właściwość

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Web.UI.WebControls.WebParts
Zestaw:
System.Web.dll

Pobiera lub ustawia typ interfejsu użytkownika używanego do wyświetlania zawartości Pomocy dla kontrolki 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

Wartość właściwości

WebPartHelpMode

WebPartHelpMode Jedna z wartości. Wartość domyślna to Modal.

Atrybuty
ThemeableAttribute PersonalizableAttribute

Wyjątki

ArgumentOutOfRangeException

Określona wartość nie jest jedną z WebPartHelpMode wartości.

Przykłady

W poniższym przykładzie kodu pokazano użycie HelpMode właściwości w celu wyświetlenia Pomocy dla kontrolki w tym samym oknie przeglądarki. Pierwsza część tego przykładu zakłada użycie niestandardowej kontrolki , TextDisplayWebPartktóra znajduje się w sekcji Przykład w przeglądzie WebPart klasy.

Przykładowy kod zawiera również stronę HTML zawierającą fikcyjną zawartość Pomocy dla kontrolki TextDisplayWebPart . W tym przykładzie należy zapisać następujący kod w pliku o nazwie Textwebparthelp.htm i umieścić go w tym samym katalogu witryny co strona .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>

Ostatnią częścią przykładu jest strona sieci Web przedstawiająca sposób odwoływanie się do kontrolki TextDisplayWebPart . Należy pamiętać, HelpMode że w adiustacji deklaratywnej wartość właściwości jest ustawiona na Navigate, a kod ustawia również wartość HelpUrl właściwości na nazwę pliku HTML zawierającego zawartość Pomocy. Załaduj stronę do przeglądarki i kliknij czasownik pomocy w menu czasowników kontrolki WebPart .

<%@ 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>

Uwagi

Użyj właściwości , HelpMode aby określić sposób wyświetlania zawartości Pomocy dla kontrolki w przeglądarce. W poniższej tabeli wymieniono efekty różnych trybów Pomocy w przeglądarce, gdy zostanie wyświetlona zawartość Pomocy dla WebPart kontrolki.

Tryb pomocy Zachowanie przeglądarki
Modal Otwiera oddzielne okno przeglądarki, jeśli przeglądarka ma tę możliwość. Użytkownik musi zamknąć okno przed powrotem do strony składników Web Part.
Modeless Otwiera oddzielne okno przeglądarki, jeśli przeglądarka ma tę możliwość. Użytkownik nie musi zamknąć okna przed powrotem do strony sieci Web.
Navigate Zamienia stronę składników Web Part w oknie przeglądarki.

Tej właściwości nie można ustawić za pomocą motywów ani motywów arkusza stylów. Aby uzyskać więcej informacji, zobacz ThemeableAttributei ASP.NET Motywy i skórki.

Zakres personalizacji tej właściwości jest ustawiony na Shared i może być modyfikowany tylko przez autoryzowanych użytkowników. Aby uzyskać więcej informacji, zobacz PersonalizableAttribute i Web Part Personalization Overview (Omówienie personalizacji składników Web Part).

Dotyczy

Zobacz też