RadWindow for ASP.NET AJAX
Contents
RadControls for ASP.NET AJAX

RadWindow has a number of client-side properties and methods that you can use to manipulate the windows in the browser. These are:

Getters/setters for the public properties

Name

Description

argument

An object that is transferred between the calling page and the RadWindow dialog.

BrowserWindow

Returns a reference to the parent page's document. This is useful for calling functions on the parent page.

get_animation

Gets the animation value for the RadWindow. Returns a variable of type Telerik.Web.UI.WindowAnimation.

get_animationDuration

Gets animation duration value for the RadWindow. The default value is 500ms.

get_autoSize

Gets a value which indicates whether the window will automatically resize itself according to its content or not.

get_browserWindow

Gets a reference to the RadWindow's parent [browser window] object.

get_centerIfModal

Returns a boolean value whether CenterIfModal is set.

get_contentElement

Gets the content element when the RadWindow is used as controls container (its ContentTemplate) and not with NavigateUrl.

get_contentFrame

Returns a reference to RadWindow's content area (IFRAME). One possible use is to to call a function that is declared in the RadWindow's page from the parent page. Another possible use is to modify the DOM.

get_cssClass

Gets the class name specified in the CssClass property.

get_destroyOnClose

Gets a value indicating whether the RadWindow will be disposed and made inaccessible once it is closed.

get_enableShadow

Gets a value indicating whether the RadWindow should have a shadow.

get_height

Gets the RadWindow's height.

get_iconUrl

Gets the URL of the icon in the upper left corner of the RadWindow titlebar.

get_keepInScreenBounds

Gets a value indicating whether the RadWindow will show only in the visible viewport of the browser window.

get_left

Gets the horizontal offset relative to its offset element (usually the browser window). Corresponds to the Left server property.

get_maxHeight

Gets the maximum height of the RadWindow.

get_maxWidth

Gets the maximum width of the RadWindow.

get_minHeight

Gets the minimum height of the RadWindow.

get_minimizeIconUrl

Gets the URL of the minimized icon of the RadWindow.

get_minimizeZoneID

Gets the id (ClientID if a runat=server is used) of an HTML element where the RadWindow object will be docked when minimized.

get_minWidth

Gets the minimum width of the RadWindow.

get_modal

Gets a value indicating whether the RadWindow is modal or not.

get_name

Gets the name of the RadWindow.

get_navigateUrl

Gets the URL of the RadWindow.

get_offsetElementID

Gets the offset element ID (the element according to which the RadWindow should be positioned relatively). Works together with the Top and Left properties.

get_opacity

Gets the value indicating the opacity of the RadWindow. The value should be between 0 and 100. The default value is 100 which is opaque.

get_openerElementID

Gets the OpenerElementId of the RadWindow.

get_overlay

Gets a value indicating whether the RadWindow has an overlay element.

get_popupElement

Returns a reference to the popup element of the RadWindow.

get_reloadOnShow

Gets a value indicating whether the page that is loaded in the RadWindow should be loaded everytime from the server or will leave the browser's default behavior.

get_restrictionZoneID

Gets the id (ClientID if a runat=server is used) of an HTML element in which the RadWindow object will be able to move.

get_showContentDuringLoad

Gets a value indicating whether the page that is loaded in the RadWindow should be shown during the loading process or only when it has finished loading.

get_showOnTopWhenMaximized

Gets a value indicating whether the maximized RadWindow should be on top of the page's content. The default value is true.

get_status

Gets current message in the status area of the RadWindow.

get_title

Gets the title of the RadWindow.

get_top

Gets the vertical offset relative to its offset element. Corresponds to the Top server property.

get_visibleStatusbar

Gets the visibility of the RadWindow's status bar.

get_visibleTitlebar

Gets the visibility of the RadWindow's titlebar.

get_width

Gets the RadWindow's width.

get_windowManager

Returns a reference to the RadWindowManager. As an alternative you can use the ASP.NET AJAX convention and use $find(), e.g:oManager = $find("<%=RadWindowManager1.ClientID%>");

get_zindex

Gets the z-Index of the RadWindow.

set_animation

Sets the opening animation for the RadWindow. Takes an argument of type Telerik.Web.UI.WindowAnimation. Possible values are: None, Resize, Fade, Slide, FlyIn. For example: oWnd.set_animation(Telerik.Web.UI.WindowAnimation.Slide);

set_animationDuration

Sets animation duration value for the RadWindow.

set_autoSize

Sets a value which indicates whether the window should automatically resize itself according to its content or not.

set_autoSizeBehaviors

Sets the AutoSizeBehaviors property of the RadWindow. Its argument must be a value or combination of values from the Telerik.Web.UI.WindowAutoSizeBehaviors enum. To set more than one behavior, use "+". Possible values are Width, WidthProportional, Height, HeightProportional, Default. For example: (Telerik.Web.UI.WindowAutoSizeBehaviors.Width + Telerik.Web.UI.WindowAutoSizeBehaviors.Height)

set_behaviors

Sets the Behaviors property of the RadWindow. Its argument must be a value or combination of values from the Telerik.Web.UI.WindowBehaviors enum. To set more than one behavior, use "+". Possible values are None, Resize, Minimize, Close, Pin, Maximize, Move, Reload, Default. For example: oWnd.set_behaviors(Telerik.Web.UI.WindowBehaviors.Move + Telerik.Web.UI.WindowBehaviors.Close)

set_centerIfModal

Sets the CenterIfModal property. It is true by default, meaning a modal RadWindow will ignore the Left and Top properties. When set to false these properties will be respeected. Can be useful in the OnClientBeforeShow event.

set_contentElement

Sets the content element when the RadWindow is used as controls container (i.e. its ContentTemplate) and not with NavigateUrl. Takes a DOM object as a parameter.

set_cssClass

Sets the class name (otherwise specified in the CssClass property).

set_destroyOnClose

Sets a value indicating whether the RadWindow will be disposed and made inaccessible once it is closed.

set_enableShadow

Sets a value indicating whether the RadWindow should have a shadow.

set_height

Sets the RadWindow height in pixels.

set_iconUrl

Sets the URL of the icon in the upper left corner of the RadWindow titlebar. The new image must also be 16x16 pixels in size for correct display.

set_initialBehaviors

Sets the InitialBehaviors property of the RadWindow. Its argument must be a value or combination of values from the Telerik.Web.UI.WindowBehaviors enum. To set more than one behavior, use "+". Possible values are None, Minimize, Pin, Maximize, Default. For example: oWnd.set_initialBehaviors(Telerik.Web.UI.WindowBehaviors.Pin + Telerik.Web.UI.WindowBehaviors.Maximize)

set_keepInScreenBounds

Sets a value indicating whether the RadWindow should show only in the visible viewport of the browser window.

set_left

Sets the horizontal offset relative to its offset element in pixels. Corresponds to the Left server property.

set_maxHeight

Sets the maximum height of the RadWindow in pixels.

set_maxWidth

Sets the maximum width of the RadWindow in pixels.

set_minHeight

Sets the minimum height of the RadWindow in pixels.

set_minimizeIconUrl

Sets the URL of the minimized icon of the RadWindow.

set_minimizeZoneID

Sets the clientside id of an HTML element where the window object will be docked when minimized.

set_minWidth

Sets the minimum width of the RadWindow in pixels.

set_modal

Sets the modality of the RadWindow. It accepts a boolean value as an argument, e.g. oWnd.set_modal(true);

set_offsetElementID

Sets the OffsetElementId (clientside id of an HTML element according to which the RadWindow will be positioned).

set_opacity

Sets the value indicating the opacity of the RadWindow. The value should be between 0 and 100. The default value is 100 which is opaque.

set_openerElementID

Sets the OpenerElementId for the RadWindow. This is the HTML element that will open the RadWindow when clicked. Note that if it is a postback element its server-side handlers will not fire.

set_overlay

Sets a value indicating whether the RadWindow should create an overlay element.

set_reloadOnShow

Sets a value indicating whether the page that is loaded in the RadWindow should be loaded everytime from the server or will leave the browser's default behaviour.

set_restrictionZoneID

Sets the clientside id of an HTML element in which the window object will be able to move.

set_showContentDuringLoad

Sets a value indicating whether the page that is loaded in the RadWindow should be shown during the loading process or when it has finished loading.

set_status

Sets the message in the status area of the RadWindow.

set_title

Sets the RadWindow's title. Note that if the content page has its own title set in the @Page directive or in the <head> section, this title will override the RadWindow's one.

set_top

Sets the vertical offset relative to its offset element in pixels. Corresponds to the Top server property.

set_visibleStatusbar

Sets the visibility of the RadWindow's status bar. Accepts true/false as parameter.

set_visibleTitlebar

Sets the visibility of the RadWindow's titlebar. Accepts true/false as parameter.

set_width

Sets the RadWindow's width in pixels.

Methods that check a condition or invoke a certain behavior

Name

Description

addShortcut

Adds the specified shortcut string to the given command. Takes two string parameters - the command and its shortcut.

autoSize

Changes RadWindow's size to fit the content page. It cannot be used with pages from other domains due to browsers' security restrictions. You can optionally call the method with argument true - this will make the autosizing perform an animation while adjusting the size.

center

Centers the RadWindow in the middle of the page (or its restriction zone if set).

close

Closes the RadWindow. Must be called from a RadWindow object, not from the window object when in a content page. You can pass an argument to it that is easily obtained from the main page, see this article for details.

getShortcutString

Returns the last shortcut for the command that is passed as an argument (string).

getWindowBounds

Returns the size and position of the RadWindow

e.g:

var bounds = oWnd.getWindowBounds();

bounds.x; //returns the current left position of the RadWindow

bounds.y; //returns the current top position of the RadWindow

bounds.height; //returns the current height of the RadWindow

bounds.width; //returns the current width of the RadWindow

hide

Makes the window invisible.

isActive

Returns true if the RadWindow is the currently active one.

isAutoSizeBehaviorEnabled

Indicates whether a certain autosize behavior is enabled for the RadWindow. Takes an argument of type Telerik.Web.UI.WindowAutoSizeBehaviors and returns a boolean value

isBehaviorEnabled

Indicates whether a certain behavior is enabled for the RadWindow. Takes an argument of type Telerik.Web.UI.WindowBehaviors and returns a boolean value.

isClosed

Returns true if the RadWindow is currently closed.

isCreated

Indicates whether the UI of the RadWindow is already created or not.

isInitialBehaviorEnabled

Indicates whether a certain initial behavior is enabled for the RadWindow. Takes an argument of type Telerik.Web.UI.WindowBehaviors and returns a boolean value.

isMaximized

Returns true if the RadWindow is currently maximized.

isMinimized

Returns true if the RadWindow is currently minimized.

isModal

Returns true if the RadWindow is modal.

isPinned

Returns true if the RadWindow is currently pinned.

isShortcutAdded

Returns true if a shortcut is added for the command passed as a string argument.

isVisible

Returns true if the RadWindow is currently visible.

maximize

Maximizes the RadWindow.

minimize

Minimizes the RadWindow.

moveTo

Sets the position of the RadWindow in pixels. Takes two integer arguments - left and top (in this order).

reload

Reloads the content page in the RadWindow. The page should come from the same server as is the parent page due to JavaScript's cross-site scripting limitations.

restore

Restores the RadWindow to its normal (non-minimized) state.

removeAllShortcutsCommand

Clears all shortcuts for the given command (passed as a string parameter).

removeShortcut

Removes the last shortcut for the given command (passed as a string parameter).

setActive

Takes a boolean argument that, if true, makes the RadWindow the active (topmost) window on the page, otherwise makes it lose focus.

setSize

Sets the size of the RadWindow in pixels. Takes two integer arguments for the width and height (in this order).

setUrl

Changes the URL of the RadWindow.

show

Shows the RadWindow if it was invisible. If it does not exist, show() creates it.

togglePin

Toggles whether the RadWindow is pinned.

Examples

CopyJavaScript
// UseRadWindow shows how to get a reference to a RadWindow
// and use it to call various methods
function UseRadWindow()
{
    var oWnd = $find("<%= DialogWindow.ClientID %>");
    oWnd.show();
    oWnd.setSize(400, 400);
    oWnd.setUrl("http://www.yahoo.com");
    oWnd.minimize();
    oWnd.maximize();
    oWnd.restore();
}
// ShowWindow illustrates another way to get a reference
// to a RadWindow and set properties based on UI elements
function ShowWindow()
{
    var manager = GetRadWindowManager();
    // txtShowWindow is the id of a textarea on the page
    var txtShowWindow = document.getElementById("txtShowWindow");
    var window1 = manager.getWindowByName("RadWindow1");
    window1.setUrl(txtShowWindow.value);
    window1.set_title(txtShowWindow.value);
    window1.show();
}

//open a RadWindow and set a function to be called
//when the RadWindow is closed
function openWindow()
{
    //get a reference to the window
    var oWnd = $find("<%= RadWindow1.ClientID %>");
    //set its NavigateUrl
    oWnd.setUrl("http://www.telerik.com");
    //add the name of the function to be executed when RadWindow is closed
    oWnd.add_close(OnClientClose);
    //show the window
    oWnd.show();
}
function OnClientClose(oWnd, eventArgs)
{
    //your code here
    //remove the OnClientClose function to avoid
    //adding it for a second time when the window is shown again
    oWnd.remove_close(OnClientClose);
}

See Also

Other Resources

RadWindowManager API