Controls / Window / Client Side Programming

New to Telerik UI for ASP.NET AJAX? Download free 30-day trial

RadWindow Object

In this article, we list the numerous client-side properties and methods exposed by the client-side RadWindow object. These properties and methods allow you to manipulate the windows in the browser. Additionally, you can use these methods in various client-side events and produce the logic required by your scenario.

At the end of the article, you will find a basic example that demonstrates how to call methods, set properties, and handle events.

You can also create RadWindow instances dynamically through the RadWindowManager client-side object.

This article contains the following sections:

Getters/Setters for the Public Properties

Getters/setters for the public properties

Name Description
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 that 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 a controls container (its ContentTemplate ) and not with NavigateUrl .
get_contentFrame Returns a reference to RadWindow's content area (IFRAME). One possible use is 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 value of the RadWindow's server Height property. To get the current dimensions, use the getWindowBounds method.
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 and returns its value. To get the current position, use the getWindowBounds method.
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 every time from the server or whether the browser's default behavior will be left.
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 and returns its value. To get the current position, use the getWindowBounds method.
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 value of the RadWindow's server Width property. To get the current dimensions, use the getWindowBounds method.
get_windowManager Returns a reference to the RadWindowManager . As an alternative, you can use the ASP.NET AJAX convention and use $find(), for example: 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 the animation duration value for the RadWindow .
set_autoSize Sets a value that 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 and 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 respected. Can be useful in the OnClientBeforeShow event.
set_contentElement Sets the content element when the RadWindow is used as a controls container (i.e., its ContentTemplate ) and not with NavigateUrl . Takes a DOM object as a parameter.
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 title bar. 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 and 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 client-side 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_navigateUrl Sets the URL RadWindow will navigate to. Does not create the markup of the dialog or load the content page. To load the content page and show the dialog use setUrl and show respectively.
set_offsetElementID Sets the OffsetElementId (client-side ID of an HTML element where RadWindow will be positioned).
set_opacity Sets the value indicating the opacity of the Boolean. 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 every time from the server or whether the browser's default behavior will be left.
set_restrictionZoneID Sets the client-side 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 section, this title will override the RadWindow's declaratively configured 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 its parameter.
set_visibleTitlebar Sets the visibility of the RadWindow's titlebar. Accepts True / False as its parameter.
set_width Sets the RadWindow's width in pixels.

Methods that Check a Condition or Invoke a Certain Behavior

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. You cannot use the autoSize method with pages from other domains due to browsers' security restrictions. You can optionally call the autoSize method with an argument set to 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 . For example: 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 RadWindow 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 there is a shortcut added to the command. The command name is 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 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 thegiven 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 when the passed parameter is false , the setActive method makes the control 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. It will load the content page and create the markup of the dialog even if it has not been shown yet. To simply set the page without navigating to it, use set_navigateUrl.
show Shows the RadWindow if it was invisible. If it does not exist, show() creates it.
togglePin Toggles whether the RadWindow is pinned.

Methods for Modifying Client-side Event Handlers Dynamically

Methods for modifying client-side event handlers dynamically.

Name Description
add_activate Adds a function that will be called when a RadWindow is activated. The name of this function can also be declared in the OnClientActivate property.
add_autoSizeEnd Adds a function that will be called when a RadWindow has finished resizing when the AutoSize functionality has taken effect. The name of this function can also be declared in the OnClientAutoSizeEnd property.
add_beforeClose Adds a function that will be called before RadWindow is closed. You can cancel the closing of RadWindow there by using set_cancel(true) . The name of this function can also be declared in the OnClientBeforeClose property.
add_beforeShow Adds a function that will be called before RadWindow is shown. You can cancel the closing of RadWindow there by using set_cancel(true) . The name of this function can also be declared in the OnClientBeforeShow property.
add_close Adds a function that will be called when a RadWindow is closed. The name of this function can also be declared in the OnClientClose property.
add_command TAdds a function that will be called when the commands Pin, Reload, Minimize and Maximize are executed (when the user presses a titlebar button). The name of this function can also be declared in the OnClientCommand property.
add_dragEnd Adds a function that will be called when the user has finished dragging a RadWindow. The name of this function can also be declared in the OnClientDragEnd property
add_dragStart Adds a function that will be called when the user starts dragging a RadWindow. The name of this function can also be declared in the OnClientDragStart property.
add_pageLoad Adds a function that will be called when a RadWindow's content page is fully loaded. The name of this function can also be declared in the OnClientPageLoad property.
add_resize Adds a function that will be called when the RadWindow is being resized. The name of this function can also be set in the OnClientResize property.
add_resizeEnd Adds a function that will be called when the RadWindow is resized. The name of this function can also be set in the OnClientResizeEnd property.
add_resizeStart Adds a function that will be called when the RadWindow resizing is started. The name of this function can also be set in the OnClientResizeStart property.
add_show Adds a function that will be called when a RadWindow is shown. The name of this function can also be set in the OnClientShow property.
remove_activate Removes a function declared with the add_activate function.
remove_autoSizeEnd Removes a function declared with the add_autoSizeEnd function.
remove_beforeClose Removes a function declared with the add_beforeclose function.
remove_beforeShow Removes a function declared with the add_beforeShow function.
remove_close Removes a function declared with the add_close function
remove_command Removes a function declared with the add_command function
remove_dragEnd Removes a function declared with the add_dragEnd function.
remove_dragStart Removes a function declared with the add_dragStart function.
remove_pageLoad Removes a function declared with the add_pageLoad function.
remove_resize Removes a function declared with the add_resize function.
remove_resizeEnd Removes a function declared with the add_resizeEnd function.
remove_resizeStart Removes a function declared with the add_resizeStart function.
remove_show Removes a function declared with the add_show function.

See the Setting Client Event Handlers by Using JavaScript article for an example that shows how to set client event-handlers.

Examples

// 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("https://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

In this article
Related articles
Not finding the help you need? Improve this article