Inserts the pane at the end of the document. This will also add the pane to the rootResponder.

Inserts the pane into the DOM.

Make the pane receive key events. Until you call this method, the keyView set for this pane will not receive key events.

Invoked when the view is about to lose its mainPane status. The default implementation will also remove the pane from the document since you can't have more than one mainPane in the document at a time.

Invoked when the the pane is about to lose its focused pane status. Override to implement your own custom handling

The parent dimensions are always the last known window size.
Defined in: layout.js.

Called just after the keyPane focus has changed to the receiver. Notifies the keyView of its new status. The keyView should use this method to update its display and actually set focus on itself at the browser level if needed.

Called just after the pane has lost its keyPane status. Notifies the current keyView of the change. The keyView can use this method to do any final cleanup and changes its own display value if needed.

Invoked when the pane is about to become the focused pane. Override to implement your own custom handling.

Invokes when the view is about to become the new mainPane. The default implementation simply updates the isMainPane property. In your subclass, you should make sure your pane has been added to the document before trying to make it the mainPane. See SC.MainPane for more information.

Returns YES if wantsTouchIntercept and this is a touch platform.

Inserts the current pane into the page. The actual DOM insertion is done by a function passed into insert, which receives the layer as a parameter. This function is responsible for making sure a layer exists, is not already attached, and for calling paneDidAttach when done.

pane = SC.Pane.create();
pane.insert(function(layer) {
  jQuery(layer).insertBefore("#otherElement");
});

Makes the passed view (or any object that implements SC.Responder) into the new firstResponder for this pane. This will cause the current first responder to lose its responder status and possibly keyResponder status as well.

Pane's never have a next responder.

This has been deprecated and may cause issues when used. Please use didAppendToDocument instead, which is not defined by SC.Pane (i.e. you don't need to call sc_super when implementing didAppendToDocument in direct subclasses of SC.Pane).

Defined in: keyboard.js.

Inserts the pane's layer as the first child of the passed element.
Defined in: manipulation.js.

This method is called after the pane is attached and before child views are notified that they were appended to the document. Override this method to recompute properties that depend on the pane's existence in the document but must be run prior to child view notification.

Removes the pane from the document.

This will not destroy the pane's layer or destroy the pane itself.

This method has no effect in the pane. Instead use remove().
Defined in: manipulation.js.

Remove the pane view status from the pane. This will simply set the keyPane on the rootResponder to null.

Attempts to send the specified event up the responder chain for this pane. This method is used by the RootResponder to correctly delegate mouse, touch and keyboard events. You can also use it to send your own events to the pane's responders, though you will usually not do this.

A responder chain is a linked list of responders - mostly views - which are each sequentially given an opportunity to handle the event. The responder chain begins with the event's target view, and proceeds up the chain of parentViews (via the customizable nextResponder property) until it reaches the pane and its defaultResponder. You can specify the target responder; by default, it is the pane's current firstResponder (see SC.View keyboard event documentation for more on the first responder).

Beginning with the target, each responder is given the chance to handle the named event. In order to handle an event, a responder must implement a method with the name of the event. For example, to handle the mouseDown event, expose a mouseDown method. If a responder handles a method, then the event will stop bubbling up the responder chain. (If your responder exposes a handler method but you do not always want to handle that method, you can signal that the method should continue bubbling up the responder chain by returning NO from your handler.)

In some rare cases, you may want to only alert part of the responder chain. For example, SC.ScrollView uses this to capture a touch to give the user a moment to begin scrolling on otherwise-tappable controls. To accomplish this, pass a view (or responder) as the untilResponder argument. If the responder chain includes this view, it will break the chain there and not proceed. (Note that the untilResponder object will not be given a chance to respond to the event.)

Changes the body overflow according to whether minWidth or minHeight are present in the layout hash. If there are no minimums, nothing is done unless true is passed as the first argument. If so, then overflow:hidden; will be used.

It's possible to call this manually and pass YES to remove overflow if setting layout to a hash without minWidth and minHeight, but it's probably not a good idea to do so unless you're doing it from the main pane. There's only one body tag, after all, and if this is called from multiple different panes, the panes could fight over whether it gets an overflow if care isn't taken!

Defined in: layout.js.

Stops controlling the body overflow according to the needs of this pane.
Defined in: layout.js.

Called just before the pane becomes keyPane. Notifies the current keyView that it is about to gain focus. The keyView can use this opportunity to prepare itself, possibly stealing any value it might need to steal from the current key view.

Called just before the pane loses it's keyPane status. This will notify the current keyView, if there is one, that it is about to lose focus, giving it one last opportunity to save its state.

Invoked by the root responder whenever the window resizes. This should simply begin the process of notifying children that the view size has changed, if needed.

Defined in: layout.js.