Infragistics logo
메뉴
.NET and JavaScript UI Controls
Version

AllowMaximize Property (PaneSettings)

Returns or sets whether the maximize button is enabled.
Syntax
'Declaration
 
Public Property AllowMaximize As Infragistics.Win.DefaultableBoolean
public Infragistics.Win.DefaultableBoolean AllowMaximize {get; set;}
Remarks

For the maximize button to be visible on any pane, the UltraDockManager.ShowMaximizeButton property of the control must be set to True. The default value for ShowMaximizeButton is False.

The AllowMaximize property determines whether a pane can be maximized within a group. In order for a pane to be maximized, it must be in a group with at least one other pane, and the group cannot be a tabbed or sliding group. When a pane is maximized, all other panes in the group are reduced to their minimum size, showing only the title bar. (Note that this is not the same as being minimized.) Only one pane in a group may be maximized at one time. If a pane is maximized, and the user maximizes a second pane, the first pane is automatically restored.

How other panes in a group are resized to accommodate a maximized pane varies depending on whether the group is split horizontally or vertically. A horizontally split group will maximize the height of the maximized pane. Other panes will be reduced to a title bar above or below the maximized pane. If the group is vertically split, the width of the pane will be maximized, with the title bars of other panes appearing to the left or right of the maximized pane.

Typically, you will not make use of maximizing and minimizing of panes in the same group at the same time. Because of the requirement that one pane must fill the group area at all times, minimization and maximization do not behave exactly as they do for other windows. Therefore, you risk confusing the user of your application by providing both functions simultaneously.

Example
The following examples demonstrates initializing the Settings property of a DockableControlPane to control the behavior and appearance of the specified pane.

Imports Infragistics.Shared
Imports Infragistics.Win
Imports Infragistics.Win.UltraWinDock

Private Sub btnInitializeTreePane_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles btnInitializeTreePane.Click

    Me.InitializeDockedPane(Me.ultraDockManager1.PaneFromControl(Me.UltraTree1))

End Sub

Private Sub InitializeDockedPane(ByVal pane As DockableControlPane)

    ' Move the pane to a dock area by itself
    pane.Dock(DockedSide.Left)

    ' Prevent it from being closed
    pane.Settings.AllowClose = DefaultableBoolean.False

    ' Do not allow it to be docked or floated by a drag
    pane.Settings.AllowDockBottom = DefaultableBoolean.False
    pane.Settings.AllowDockLeft = DefaultableBoolean.False
    pane.Settings.AllowDockRight = DefaultableBoolean.False
    pane.Settings.AllowDockTop = DefaultableBoolean.False
    pane.Settings.AllowFloating = DefaultableBoolean.False

    ' Do not allow it to toggle its docked state
    pane.Settings.DoubleClickAction = PaneDoubleClickAction.None

    ' It cannot be minimed or maximized
    pane.Settings.AllowMaximize = DefaultableBoolean.False
    pane.Settings.AllowMinimize = DefaultableBoolean.False

    ' It cannot be pinned
    pane.Settings.AllowPin = DefaultableBoolean.False

    ' Change the borderstyle around the contained control
    pane.Settings.BorderStylePane = UIElementBorderStyle.Raised

    ' Put 3 pixels of padding around the contained control
    pane.Settings.PaddingBottom = 3
    pane.Settings.PaddingLeft = 3
    pane.Settings.PaddingRight = 3
    pane.Settings.PaddingTop = 3

    ' Show the caption
    pane.Settings.ShowCaption = DefaultableBoolean.True

End Sub
using Infragistics.Shared;
using Infragistics.Win;
using Infragistics.Win.UltraWinDock;
using System.Diagnostics;

private void btnInitializeTreePane_Click(object sender, System.EventArgs e)
{

	this.InitializeDockedPane( this.ultraDockManager1.PaneFromControl(this.ultraTree1) );

}

private void InitializeDockedPane(DockableControlPane pane)
{

	// Move the pane to a dock area by itself
	pane.Dock(DockedSide.Left);

	// Prevent it from being closed
	pane.Settings.AllowClose = DefaultableBoolean.False;

	// Do not allow it to be docked or floated by a drag
	pane.Settings.AllowDockBottom = DefaultableBoolean.False;
	pane.Settings.AllowDockLeft = DefaultableBoolean.False;
	pane.Settings.AllowDockRight = DefaultableBoolean.False;
	pane.Settings.AllowDockTop = DefaultableBoolean.False;
	pane.Settings.AllowFloating = DefaultableBoolean.False;

	// Do not allow it to toggle its docked state
	pane.Settings.DoubleClickAction = PaneDoubleClickAction.None;

	// It cannot be minimed or maximized
	pane.Settings.AllowMaximize = DefaultableBoolean.False;
	pane.Settings.AllowMinimize = DefaultableBoolean.False;

	// It cannot be pinned
	pane.Settings.AllowPin = DefaultableBoolean.False;

	// Change the borderstyle around the contained control
	pane.Settings.BorderStylePane = UIElementBorderStyle.Raised;

	// Put 3 pixels of padding around the contained control
	pane.Settings.PaddingBottom = 3;
	pane.Settings.PaddingLeft = 3;
	pane.Settings.PaddingRight = 3;
	pane.Settings.PaddingTop = 3;

	// Show the caption
	pane.Settings.ShowCaption = DefaultableBoolean.True;

}
Requirements

Target Platforms: Windows 10, Windows 8.1, Windows 8, Windows 7, Windows Server 2012, Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

See Also