/// <summary> /// Creates an <code>ItemNavigation</code> delegate that can be attached to controls requiring capabilities for keyboard navigation between items. /// </summary> /// <param name="oDomRef">The root DOM reference that includes all items</param> /// <param name="aItemDomRefs">Array of DOM references representing the items for the navigation</param> /// <param name="bNotInTabChain">Whether the selected element should be in the tab chain or not</param> public extern ItemNavigation(Retyped.dom.HTMLElement oDomRef, Retyped.dom.HTMLElement[] aItemDomRefs, bool bNotInTabChain = false);
/// <summary> /// Collects descendants of the given root node that need to be preserved before the root node is wiped out. The "to-be-preserved" nodes are moved to a special, hidden 'preserve' area. /// /// A node is declared "to-be-preserved" when it has the <code>data-sap-ui-preserve</code> attribute set. When the optional parameter <code>bPreserveNodesWithId</code> is set to true, then nodes with an id are preserved as well and their <code>data-sap-ui-preserve</code> attribute is set automatically. This option is used by UIAreas when they render for the first time and simplifies the handling of predefined HTML content in a web page. /// /// The "to-be-preserved" nodes are searched with a depth first search and moved to the 'preserve' area in the order that they are found. So for direct siblings the order should be stable. /// </summary> /// <param name="oRootNode">to search for "to-be-preserved" nodes</param> /// <param name="bPreserveRoot">whether to preserve the root itself</param> /// <param name="bPreserveNodesWithId">whether to preserve nodes with an id as well</param> public extern static void preserveContent(Retyped.dom.HTMLElement oRootNode, bool bPreserveRoot = false, bool bPreserveNodesWithId = false);
/// <summary> /// Renders the given control to the provided DOMNode. /// /// If the control is already rendered in the provided DOMNode the DOM of the control is replaced. If the control is already rendered somewhere else the current DOM of the control is removed and the new DOM is appended to the provided DOMNode. /// /// This function must not be called within control renderers. /// </summary> /// <param name="oControl">the Control that should be rendered.</param> /// <param name="oTargetDomNode">The node in the DOM where the result of the rendering should be inserted.</param> public extern virtual void render(sap.ui.core.Control oControl, Retyped.dom.HTMLElement oTargetDomNode);
/// <summary> /// Scrolls to an element within a container. /// </summary> /// <param name="oElement">A DOM element.</param> /// <param name="iTime">The duration of animated scrolling in milliseconds. To scroll immediately without animation, give 0 as value.</param> /// <param name="Specifies">the offset left and top for the DOM Element.</param> /// <returns></returns> public extern virtual [email protected] scrollToElement(Retyped.dom.HTMLElement oElement, int iTime, object[] Specifies);
/// <summary> /// Renders the content of the rendering buffer into the provided DOM node. /// /// This function must not be called within control renderers. /// /// Usage: <pre> /// /// // Create a new instance of the RenderManager /// var rm = sap.ui.getCore().createRenderManager(); /// /// // Use the writer API to fill the buffers /// rm.write(...); /// rm.renderControl(oControl); /// rm.write(...); /// ... /// /// // Finally flush the buffer into the provided DOM node (The current content is removed) /// rm.flush(oDomNode); /// /// // If the instance is not needed anymore, destroy it /// rm.destroy(); /// /// </pre> /// </summary> /// <param name="oTargetDomNode">Node in the DOM where the buffer should be flushed into</param> /// <param name="bDoNotPreserve">Determines whether the content is preserved (<code>false</code>) or not (<code>true</code>)</param> /// <param name="vInsert">Determines whether the buffer of the target DOM node is expanded (<code>true</code>) or replaced (<code>false</code>), or the new entry is inserted at a specific position (value of type <code>int</code>)</param> public extern virtual void flush(Retyped.dom.HTMLElement oTargetDomNode, bool bDoNotPreserve, Union <bool?, int?> vInsert);
/// <summary> /// Enhances the given DOM element by parsing the Control and Elements info and creating the SAPUI5 controls for them. /// </summary> /// <param name="oElement">the DOM element to compile</param> /// <param name="oView">The view instance to use</param> public extern static void compile(Retyped.dom.HTMLElement oElement, sap.ui.core.mvc.HTMLView oView);
/// <summary> /// Enhances the given DOM element by parsing the Control and Elements info and creating the SAPUI5 controls for them. /// </summary> /// <param name="oElement">the DOM element to compile</param> public extern static void compile(Retyped.dom.HTMLElement oElement);
/// <summary> /// To prevent from the layout thrashing of the <code>textContent</code> call, this method first tries to set the <code>nodeValue</code> of the first child if it exists. /// </summary> /// <param name="oDomRef">DOM reference of the text node container.</param> public extern static void setNodeValue(Retyped.dom.HTMLElement oDomRef);
/// <summary> /// Enhances the given DOM element by parsing the Control and Elements info and creating the SAPUI5 controls for them. /// </summary> /// <param name="oElement">the DOM element to compile</param> /// <param name="oView">The view instance to use</param> /// <param name="isRecursive">Whether the call of the function is recursive.</param> public extern static void compile(Retyped.dom.HTMLElement oElement, sap.ui.core.mvc.HTMLView oView, bool isRecursive);
/// <summary> /// Caches and returns the computed line height of the text. /// </summary> /// <param name="oDomRef">DOM reference of the text container.</param> /// <returns>returns calculated line height</returns> public extern virtual int getLineHeight(Retyped.dom.HTMLElement oDomRef);
/// <summary> /// Clamps the wrapping text according to max lines and returns the found ellipsis position. Parameters can be used for better performance. /// </summary> /// <param name="oDomRef">DOM reference of the text container.</param> /// <returns>Returns found ellipsis position or undefined.</returns> public extern virtual int?clampText(Retyped.dom.HTMLElement oDomRef);
/// <summary> /// Clamps the wrapping text according to max lines and returns the found ellipsis position. Parameters can be used for better performance. /// </summary> /// <param name="oDomRef">DOM reference of the text container.</param> /// <param name="iStartPos">Start point of the ellipsis search.</param> /// <returns>Returns found ellipsis position or undefined.</returns> public extern virtual int?clampText(Retyped.dom.HTMLElement oDomRef, int iStartPos);
/// <summary> /// Sets the max height to support <code>maxLines</code> property. /// </summary> /// <param name="oDomRef">DOM reference of the text container.</param> /// <returns>Calculated max height value.</returns> public extern virtual int clampHeight(Retyped.dom.HTMLElement oDomRef);
/// <summary> /// Sets some new DOM content for this HTML control. The content will replace the existing content after the next rendering. Properties are not modified, but preferDOM should be set to true. /// </summary> /// <param name="oDom">the new DOM content</param> /// <returns><code>this</code> to facilitate method chaining</returns> public extern virtual sap.ui.core.HTML setDOMContent(Retyped.dom.HTMLElement oDom);
