` element selected state. * For example, even if `

` and `

` are selected, * this is set to false. * @param aLI true if "li" list items are selected. * @param aDT true if "dt" list items are selected. * @param aDD true if "dd" list items are selected. */ void getListItemState(out boolean aMixed, out boolean aLI, out boolean aDT, out boolean aDD); /** * getAlignment returns what alignment is in the selection. * @param aMixed Always returns false. * @param aAlign enum value for first encountered alignment * (left/center/right) */ void getAlignment(out boolean aMixed, out short aAlign); /** * Document me! * */ [can_run_script] void makeOrChangeList(in AString aListType, in boolean entireList, in AString aBulletType); /** * removeList removes list items (

, and

) and list structures * (

, and

). * * @param aListType Unused. */ [can_run_script] void removeList(in AString aListType); /** * Document me! * */ [can_run_script] void indent(in AString aIndent); /** * Document me! * */ [can_run_script] void align(in AString aAlign); /** * GetElementOrParentByTagName() looks for an element node whose name matches * aTagName from aNode or anchor node of Selection to element. * * @param aTagName The tag name which you want to look for. * Must not be empty string. * If "list", the result may be

* element. * If "td", the result may be or . * If "href", the result may be element * which has "href" attribute with non-empty value. * If "anchor", the result may be which has * "name" attribute with non-empty value. * @param aNode If non-null, this starts to look for the result * from it. Otherwise, i.e., null, starts from * anchor node of Selection. * @return If an element which matches aTagName, returns * an Element. Otherwise, nullptr. */ Element getElementOrParentByTagName(in AString aTagName, in Node aNode); /** * getSelectedElement() returns a "selected" element node. "selected" means: * - there is only one selection range * - the range starts from an element node or in an element * - the range ends at immediately after same element * - and the range does not include any other element nodes. * Additionally, only when aTagName is "href", this thinks that an * element which has non-empty "href" attribute includes the range, the * element is selected. * * @param aTagName Case-insensitive element name. * If empty string, this returns any element node or null. * If "href", this returns an element which has * non-empty "href" attribute or null. * If "anchor", this returns an element which has * non-empty "name" attribute or null. * Otherwise, returns an element node whose name is * same as aTagName or null. * @return A "selected" element. */ nsISupports getSelectedElement(in AString aTagName); /** * Return a new element with default attribute values * * This does not rely on the selection, and is not sensitive to context. * * Used primarily to supply new element for various insert element dialogs * (Image, Link, NamedAnchor, Table, and HorizontalRule * are the only returned elements as of 7/25/99) * * @param aTagName The HTML tagname * Special input values for Links and Named anchors: * Use "href" to get a link node * (an "A" tag with the "href" attribute set) * Use "anchor" or "namedanchor" to get a named anchor node * (an "A" tag with the "name" attribute set) * @return The new element created. */ [can_run_script] Element createElementWithDefaults(in AString aTagName); /** * Insert an link element as the parent of the current selection * * @param aElement An "A" element with a non-empty "href" attribute */ [can_run_script] void insertLinkAroundSelection(in Element aAnchorElement); /** * Set the value of the "bgcolor" attribute on the document's element * * @param aColor The HTML color string, such as "#ffccff" or "yellow" */ [can_run_script] void setBackgroundColor(in AString aColor); /** * A boolean which is true is the HTMLEditor has been instantiated * with CSS knowledge and if the CSS pref is currently checked * * @return true if CSS handled and enabled */ attribute boolean isCSSEnabled; /** * checkSelectionStateForAnonymousButtons() may refresh editing UI such as * resizers, inline-table-editing UI, absolute positioning UI for current * Selection and focus state. When this method shows or hides UI, the * editor (and/or its document/window) could be broken by mutation observers. * FYI: Current user in script is only BlueGriffon. */ [can_run_script] void checkSelectionStateForAnonymousButtons(); boolean isAnonymousElement(in Element aElement); /** * A boolean indicating if a return key pressed in a paragraph creates * another paragraph or just inserts a
at the caret * * @return true if CR in a paragraph creates a new paragraph */ attribute boolean returnInParagraphCreatesNewParagraph; };