WebPart.Height Vlastnost
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Získá nebo nastaví výšku zóny.
public:
virtual property System::Web::UI::WebControls::Unit Height { System::Web::UI::WebControls::Unit get(); void set(System::Web::UI::WebControls::Unit value); };
[System.Web.UI.WebControls.WebParts.Personalizable]
public override System.Web.UI.WebControls.Unit Height { get; set; }
[<System.Web.UI.WebControls.WebParts.Personalizable>]
member this.Height : System.Web.UI.WebControls.Unit with get, set
Public Overrides Property Height As Unit
Hodnota vlastnosti
Objekt Unit , který označuje výšku objektu WebPartZone. Výchozí typ objektu Unit je pixely, jak je uvedeno vlastností Type .
- Atributy
Příklady
Následující příklad kódu ukazuje problém vykreslování, který má vliv na výšku ovládacích WebPart prvků v .WebPartZone Pokud chcete tento problém předvést, musíte stránku spustit v Internet Explorer.
Všimněte si, že orientace zóny je nastavena na vodorovnou a že výška zóny a ovládací prvky v ní nejsou explicitně nastaveny. Výsledkem je, že v WebPartZone, kratší WebPart ovládací prvek se při vykreslování neroztáhne na výšku zóny. Pokud však odeberete DOCTYPE deklaraci ze stránky a znovu spustíte stránku, k problému nedojde, protože teď prohlížeč stránku nevykreslí v režimu standardů.
<%@ Page Language="C#"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
protected void Button1_Click(object sender, EventArgs e)
{
wpmgr.DisplayMode = WebPartManager.DesignDisplayMode;
}
protected void Button2_Click(object sender, EventArgs e)
{
wpmgr.DisplayMode = WebPartManager.BrowseDisplayMode;
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>Untitled Page</title>
</head>
<body>
<form id="form1" runat="server">
<asp:webpartmanager id="wpmgr" runat="server" />
<asp:webpartzone id="WebPartZone1" runat="server"
layoutorientation="horizontal">
<zonetemplate>
<asp:textbox id="TextBox1" runat="server" title="Text input">
</asp:textbox>
<asp:calendar id="Calendar1" runat="server" title="Personal Calendar" />
</zonetemplate>
</asp:webpartzone>
<asp:button id="Button1" runat="server" text="Design Mode"
onclick="Button1_Click" />
<br />
<asp:button id="Button2" runat="server" onclick="Button2_Click"
text="Browse Mode" />
</form>
</body>
</html>
<%@ Page Language="VB"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
Protected Sub Button1_Click(ByVal sender As Object, _
ByVal e As System.EventArgs)
wpmgr.DisplayMode = WebPartManager.DesignDisplayMode
End Sub
Protected Sub Button2_Click(ByVal sender As Object, _
ByVal e As System.EventArgs)
wpmgr.DisplayMode = WebPartManager.BrowseDisplayMode
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>Untitled Page</title>
</head>
<body>
<form id="form1" runat="server">
<asp:webpartmanager id="wpmgr" runat="server" />
<asp:webpartzone id="WebPartZone1" runat="server"
layoutorientation="horizontal">
<zonetemplate>
<asp:textbox id="TextBox1" runat="server" title="Text input">
</asp:textbox>
<asp:calendar id="Calendar1" runat="server" title="Personal Calendar" />
</zonetemplate>
</asp:webpartzone>
<asp:button id="Button1" runat="server" text="Design Mode"
onclick="Button1_Click" />
<br />
<asp:button id="Button2" runat="server" onclick="Button2_Click"
text="Browse Mode" />
</form>
</body>
</html>
Pokud chcete zjistit, jak alternativní řešení (popsané v části Poznámky) funguje, zkuste k prvku přidat height atribut <asp:webpartzone> a zachovat DOCTYPE deklaraci na stránce. K přidání atributu do značky můžete použít následující kód:
Height="200px"
Spusťte stránku a oba WebPart ovládací prvky se roztáhnou, aby vyplnily explicitně deklarovanou výšku zóny.
S tímto příkladem kódu můžete také experimentovat a sledovat problém s vykreslováním souvisejícím s výškou v jiném scénáři, ke kterému dochází, když je zóna LayoutOrientation nastavená na Vertical. Odeberte existující LayoutOrientation atribut a jeho hodnotu z elementu <asp:webpartzone> , což způsobí, že orientace zóny se vrátí k výchozí svislé orientaci. Nastavte atribut height prvku <asp:webpartzone> na 200 pixelů, jak jste to udělali výše, a spusťte stránku. Výška zóny vypadá příliš velká a ovládací prvky nejsou úměrné výšce zóny. Teď odeberte atribut height a znovu spusťte stránku. Ovládací prvky se teď vykreslují vzhledem k výšce zóny.
Poznámky
Internet Explorer režimy vykreslování můžou ovlivnit výšku ovládacího prvku WebPart a výšku zóny, která ji obsahuje. Internet Explorer vykresluje webové stránky buď v režimu kompatibility (zpětně kompatibilní s předchozími verzemi prohlížeče), nebo v režimu standardů (určeném přítomností deklarace DOCTYPE na stránce). Informace o těchto režimech naleznete v DHTML compatMode vlastnost.
Když Internet Explorer vykresluje stránku v režimu standardů, nemusí za určitých okolností měnit velikost buněk v tabulkách, i když je kód HTML buňky <td height="100%">. V důsledku toho se ovládací prvky a jejich obsahující zóna vykreslují tak, WebPart aby se ovládací prvky nepřetahovaly na plnou výšku zóny.
Pokud je Internet Explorer ve standardním režimu, ovládací prvky se nevykreslují tak, aby se v následujících případech roztahovaly na plnou výšku:
Pokud je vlastnost zóny LayoutOrientation nastavena Vertical a explicitně nastavíte výšku zóny. Chcete-li povolit ovládacím prvkům vyplnit plnou výšku zóny, nezadávejte výšku vodorovně orientované zóny.
Pokud je vlastnost zóny LayoutOrientation nastavena Horizontal a nenastavíte explicitně výšku zóny nebo obsažených ovládacích prvků. Chcete-li povolit ovládacím prvkům vyplnit plnou výšku zóny, nastavte výšku zóny nebo ovládacích prvků ve svisle orientované zóně.