WebPartHelpMode 列舉
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
指定用來顯示 WebPart 控制項說明內容的可用使用者介面 (UI) 型別。
public enum class WebPartHelpMode
public enum WebPartHelpMode
type WebPartHelpMode =
Public Enum WebPartHelpMode
- 繼承
欄位
Modal | 0 | 如果瀏覽器有此功能,要另外開啟瀏覽器視窗。 使用者必須先關閉視窗,才能回到 Web 組件頁面。 |
Modeless | 1 | 如果瀏覽器有此功能,要另外開啟瀏覽器視窗。 使用者不需要關閉視窗,就能返回 Web 網頁。 |
Navigate | 2 | 取代瀏覽器視窗中的 Web 組件頁面。 |
範例
下列範例示範如何使用 WebPart.HelpMode 屬性,在相同的瀏覽器視窗中顯示控件的說明。 此範例的第一個部分假設使用自定義控件,TextDisplayWebPart
該控件位於 類別的 WebPartExample 區段中。
此範例也包含 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。