editor.h

Go to the documentation of this file.

/* This file is part of the KDE project
 *
 * Copyright (C) 2004 Leo Savernik <l.savernik@aon.at>
 *
 * This library is free software; you can redistribute it and/or
 * modify it under the terms of the GNU Library General Public
 * License as published by the Free Software Foundation; either
 * version 2 of the License, or (at your option) any later version.
 *
 * This library is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 * Library General Public License for more details.
 *
 * You should have received a copy of the GNU Library General Public License
 * along with this library; see the file COPYING.LIB.  If not, write to
 * the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
 * Boston, MA 02111-1307, USA.
 */

#ifndef __EDITOR_H
#define __EDITOR_H

#include "editor_command.h"

#include <khtml_export.h>

#include <QObject>

#include "wtf/PassRefPtr.h"

class QKeyEvent;

class KHTMLPart;
class KHTMLView;
class KHTMLEditorPart;

namespace khtml {
  class EditCommandImpl;
  struct EditorContext;
}

namespace DOM {

class Range;
class NodeImpl;
class ElementImpl;
class DOMString;
class CSSStyleDeclarationImpl;
class EditorPrivate;

class KHTML_EXPORT Editor : public QObject {
  Q_OBJECT

  Editor(KHTMLPart *);
  virtual ~Editor();
public:

  enum TriState { FalseTriState, TrueTriState, MixedTriState };

  // == interface to editor commands

  bool execCommand(const DOMString &command, bool userInterface, const DOMString &value);
  bool queryCommandEnabled(const DOMString &command);
  bool queryCommandIndeterm(const DOMString &command);
  bool queryCommandState(const DOMString &command);
  bool queryCommandSupported(const DOMString &command);
  DOMString queryCommandValue(const DOMString &command);

  bool execCommand(EditorCommand, bool userInterface, const DOMString &value);
  bool queryCommandEnabled(EditorCommand);
  bool queryCommandIndeterm(EditorCommand);
  bool queryCommandState(EditorCommand);
  bool queryCommandSupported(EditorCommand);
  DOMString queryCommandValue(EditorCommand);

  // == direct interface to some built-in commands

  void copy();
  void cut();
  void paste();
  bool canPaste() const;
  void redo();
  void undo();
  bool canRedo() const;
  bool canUndo() const;
  void applyStyle(DOM::CSSStyleDeclarationImpl *);
  TriState selectionHasStyle(DOM::CSSStyleDeclarationImpl *) const;
  bool selectionStartHasStyle(DOM::CSSStyleDeclarationImpl *) const;
  DOM::DOMString selectionStartStylePropertyValue(int stylePropertyID) const;
  void print();
  DOM::CSSStyleDeclarationImpl *selectionComputedStyle(DOM::NodeImpl *&nodeToRemove) const;


  // == ### more stuff I'm not sure about whether it should be public

  WTF::PassRefPtr<khtml::EditCommandImpl> lastEditCommand() const;

  void appliedEditing(khtml::EditCommandImpl *);

  void unappliedEditing(khtml::EditCommandImpl *);

  void reappliedEditing(khtml::EditCommandImpl *);

  DOM::CSSStyleDeclarationImpl *typingStyle() const;

  void setTypingStyle(DOM::CSSStyleDeclarationImpl *);

  void clearTypingStyle();

  void closeTyping();

  void indent();
  void outdent();

private:
  bool handleKeyEvent(QKeyEvent *);

private:
  EditorPrivate *const d;

  DOM::CSSStyleDeclarationImpl *m_typingStyle;

  KHTMLPart *m_part;

  friend class ::KHTMLPart;
  friend class ::KHTMLView;
  friend class ::KHTMLEditorPart;
  friend struct khtml::EditorContext;
  friend class DOM::ElementImpl;
};

}/*namespace DOM*/

#endif // __EDITOR_H