WebPartManager.DesignDisplayMode フィールド
アセンブリ: System.Web (system.web.dll 内)
構文解説DesignDisplayMode フィールドは、WebPartManager コントロールによって作成され格納された、カスタム WebPartDisplayMode オブジェクトを参照します。これは静的オブジェクトであるため、このコントロールのインスタンスがなくても、WebPartManager クラスを通じて直接このオブジェクトを参照できます。
Web パーツ コントロールが含まれたページを初めて読み込むと、既定で BrowseDisplayMode (ブラウズ モード) になります。ユーザーが、コントロールを別のゾーンに移動したり現在のゾーン内で移動したりしてページのレイアウトを変更する場合、最初にページを DesignDisplayMode (デザイン モード) に切り替える必要があります。デザイン モードには、さまざまなゾーンのユーザー インターフェイス (UI) が表示され、ユーザーはコントロールをドラッグしてレイアウトを変更できます。
使用例プログラムを使用した DesignDisplayMode フィールドの操作方法を次のコード例に示します。このコードは、ページでサポートされる表示モード (ここでは、ブラウズ モードおよびデザイン モード) を含むドロップダウン リストを生成します。Page_PreRender メソッドで、コードは現在の DisplayMode プロパティが DesignDisplayMode に設定されているかどうかをチェックします。設定されている場合は Label1 が表示され、設定されていない場合は Label1 が非表示になります。
<%@ Page Language="VB" %> <script runat="server"> Protected Sub Page_Init(ByVal sender As Object, _ ByVal e As EventArgs) Dim mode As WebPartDisplayMode For Each mode In mgr.SupportedDisplayModes Dim modeName As String = mode.Name If mode.IsEnabled(mgr) Then Dim item As ListItem = New ListItem(modeName, modeName) DisplayModeDropdown.Items.Add(item) End If Next End Sub Protected Sub DisplayModeDropdown_SelectedIndexChanged(ByVal _ sender As Object, ByVal e As EventArgs) Dim selectedMode As String = _ DisplayModeDropdown.SelectedValue Dim mode As WebPartDisplayMode = _ mgr.SupportedDisplayModes(selectedMode) If mode IsNot Nothing Then mgr.DisplayMode = mode End If End Sub Protected Sub Page_PreRender(ByVal sender As Object, _ ByVal e As System.EventArgs) If mgr.DisplayMode.Equals(WebPartManager.DesignDisplayMode) Then Label1.Visible = True Else Label1.Visible = False End If End Sub </script> <html > <head id="Head1" runat="server"> </head> <body> <form id="form1" runat="server"> <div> <asp:WebPartManager ID="mgr" runat="server"> </asp:WebPartManager> <asp:WebPartZone ID="WebPartZone1" runat="server"> <ZoneTemplate> <asp:Calendar ID="Calendar1" runat="server" Title="My Calendar" /> </ZoneTemplate> </asp:WebPartZone> <asp:WebPartZone ID="WebPartZone2" runat="server"> <ZoneTemplate> <asp:BulletedList DisplayMode="HyperLink" ID="BulletedList1" runat="server" Title="My Links"> <asp:ListItem Value="http://www.microsoft.com"> Microsoft </asp:ListItem> <asp:ListItem Value="http://www.msn.com"> MSN </asp:ListItem> <asp:ListItem Value="http://www.contoso.com"> Contoso Corp. </asp:ListItem> </asp:BulletedList> </ZoneTemplate> </asp:WebPartZone> <hr /> <asp:Label ID="Label1" runat="server" Text="Currently in Design Mode" Font-Bold="true" Font-Size="125%" /> <br /> <asp:DropDownList ID="DisplayModeDropdown" runat="server" AutoPostBack="true" Width="120" OnSelectedIndexChanged= "DisplayModeDropdown_SelectedIndexChanged"> </asp:DropDownList> </div> </form> </body> </html>
<%@ Page Language="C#" %> <script runat="server"> protected void Page_Init(object sender, EventArgs e) { foreach (WebPartDisplayMode mode in mgr.SupportedDisplayModes) { string modeName = mode.Name; if (mode.IsEnabled(mgr)) { ListItem item = new ListItem(modeName, modeName); DisplayModeDropdown.Items.Add(item); } } } protected void DisplayModeDropdown_SelectedIndexChanged(object sender, EventArgs e) { String selectedMode = DisplayModeDropdown.SelectedValue; WebPartDisplayMode mode = mgr.SupportedDisplayModes[selectedMode]; if (mode != null) mgr.DisplayMode = mode; } protected void Page_PreRender(object sender, EventArgs e) { if (mgr.DisplayMode == WebPartManager.DesignDisplayMode) Label1.Visible = true; else Label1.Visible = false; } </script> <html > <head runat="server"> </head> <body> <form id="form1" runat="server"> <div> <asp:WebPartManager ID="mgr" runat="server"> </asp:WebPartManager> <asp:WebPartZone ID="WebPartZone1" runat="server"> <ZoneTemplate> <asp:Calendar ID="Calendar1" runat="server" Title="My Calendar" /> </ZoneTemplate> </asp:WebPartZone> <asp:WebPartZone ID="WebPartZone2" runat="server"> <ZoneTemplate> <asp:BulletedList DisplayMode="HyperLink" ID="BulletedList1" runat="server" Title="My Links"> <asp:ListItem Value="http://www.microsoft.com"> Microsoft </asp:ListItem> <asp:ListItem Value="http://www.msn.com"> MSN </asp:ListItem> <asp:ListItem Value="http://www.contoso.com"> Contoso Corp. </asp:ListItem> </asp:BulletedList> </ZoneTemplate> </asp:WebPartZone> <hr /> <asp:Label ID="Label1" runat="server" Text="Currently in Design Mode" Font-Bold="true" Font-Size="125%" /> <br /> <asp:DropDownList ID="DisplayModeDropdown" runat="server" AutoPostBack="true" Width="120" OnSelectedIndexChanged= "DisplayModeDropdown_SelectedIndexChanged"> </asp:DropDownList> </div> </form> </body> </html>
ブラウザにページを読み込んだ後、既定でブラウズ モードになります。ページ上のラベルは非表示になっています。ドロップダウン リスト コントロールを使用して、ページをデザイン モードに切り替えます。Page_PreRender メソッドのコードに従って、ここではラベルが表示されます。
プラットフォームWindows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。
バージョン情報参照- WebPartManager.DesignDisplayMode フィールドのページへのリンク
