WebPartHelpMode 列舉

  • 參考

定義

命名空間:
System.Web.UI.WebControls.WebParts
組件:
System.Web.dll

指定用來顯示 WebPart 控制項說明內容的可用使用者介面 (UI) 型別。

public enum class WebPartHelpMode
public enum WebPartHelpMode
type WebPartHelpMode = 
Public Enum WebPartHelpMode
繼承
Object
ValueType
Enum
WebPartHelpMode

欄位

Modal 0

如果瀏覽器有此功能，要另外開啟瀏覽器視窗。 使用者必須先關閉視窗，才能回到 Web 組件頁面。
Modeless 1

如果瀏覽器有此功能，要另外開啟瀏覽器視窗。 使用者不需要關閉視窗，就能返回 Web 網頁。
Navigate 2

取代瀏覽器視窗中的 Web 組件頁面。

範例

下列範例示範如何使用 WebPart.HelpMode 屬性，在相同的瀏覽器視窗中顯示控制項的說明。 此範例的第一個部分假設使用自訂控制項 ， TextDisplayWebPart 其位於 類別的 WebPartExamples區段中。

此範例也包含 HTML 頁面，其中包含控制項的虛構說明內容 TextDisplayWebPart 。 若要讓此範例正常運作，您必須將下列程式碼儲存在名為 Textwebparthelp.htm 的檔案中，並將它放在與 .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>

範例的最後一個部分是顯示如何參考控制項的 TextDisplayWebPart 網頁。 請注意，在宣告式標記中 WebPart.HelpMode ，屬性值會設定為 Navigate ，而程式碼也會將 屬性的值 WebPart.HelpUrl 設定為包含說明內容的 HTML 檔案名。 將頁面載入瀏覽器，然後按一下控制項動詞功能表上的說明 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>

備註

屬性 HelpMode 是用來判斷瀏覽器如何顯示控制項的 [說明] 內容。 列舉 WebPartHelpMode 包含可套用至 屬性的值 HelpMode 。 屬性的 HelpMode 預設值為 Modal。

適用於