KHTML
KHTMLPart Class Reference
This class is khtml's main class. More...
#include <khtml_part.h>

Public Types | |
enum | CaretDisplayPolicy { CaretVisible, CaretInvisible, CaretBlink } |
enum | DNSPrefetch { DNSPrefetchDisabled = 0, DNSPrefetchEnabled, DNSPrefetchOnlyWWWAndSLD } |
enum | FindOptions { FindLinksOnly = 1 * KFind::MinimumUserOption, FindNoPopups = 2 * KFind::MinimumUserOption } |
enum | FormNotification { NoNotification = 0, Before, Only, Unused = 255 } |
enum | GUIProfile { DefaultGUI, BrowserViewGUI } |
Public Slots | |
QVariant | executeScript (const QString &script) |
void | setActiveNode (const DOM::Node &node) |
void | setCaretMode (bool enable) |
void | setCaretVisible (bool show) |
void | setEditable (bool enable) |
void | stopAnimations () |
void | submitFormProxy (const char *action, const QString &url, const QByteArray &formData, const QString &target, const QString &contentType=QString(), const QString &boundary=QString()) |
Signals | |
void | caretPositionChanged (const DOM::Node &node, long offset) |
void | configurationChanged () |
void | docCreated () |
void | formSubmitNotification (const char *action, const QString &url, const QByteArray &formData, const QString &target, const QString &contentType, const QString &boundary) |
void | nodeActivated (const DOM::Node &) |
void | onURL (const QString &url) |
void | popupMenu (const QString &url, const QPoint &point) |
void | selectionChanged () |
Public Member Functions | |
DOM::Node | activeNode () const |
bool | autoloadImages () const |
KUrl | backgroundURL () const |
KUrl | baseURL () const |
virtual void | begin (const KUrl &url=KUrl(), int xOffset=0, int yOffset=0) |
KParts::BrowserExtension * | browserExtension () const |
KParts::BrowserHostExtension * | browserHostExtension () const |
CaretDisplayPolicy | caretDisplayPolicyNonFocused () const |
virtual bool | closeUrl () |
KParts::ReadOnlyPart * | currentFrame () const |
bool | dndEnabled () const |
DNSPrefetch | dnsPrefetch () const |
DOM::Document | document () const |
QString | documentSource () const |
DOM::Editor * | editor () const |
QString | encoding () const |
virtual void | end () |
QVariant | executeScript (const DOM::Node &n, const QString &script) |
KHTMLPart * | findFrame (const QString &f) |
KHTMLPart * | findFrameParent (KParts::ReadOnlyPart *callingPart, const QString &f, khtml::ChildFrame **childFrame=0) |
KParts::ReadOnlyPart * | findFramePart (const QString &f) |
void | findText (const QString &str, long options, QWidget *parent=0, KFindDialog *findDialog=0) |
void | findText () |
void | findTextBegin () |
bool | findTextNext (bool reverse=false) |
int | fontScaleFactor () const |
FormNotification | formNotification () const |
bool | frameExists (const QString &frameName) |
KJSProxy * | framejScript (KParts::ReadOnlyPart *framePart) |
QStringList | frameNames () const |
QList< KParts::ReadOnlyPart * > | frames () const |
bool | gotoAnchor (const QString &name) |
bool | hasSelection () const |
void | hide () |
DOM::HTMLDocument | htmlDocument () const |
bool | inProgress () const |
bool | isCaretMode () const |
bool | isEditable () const |
bool | isModified () const |
bool | isPointInsideSelection (int x, int y) |
bool | javaEnabled () const |
bool | jScriptEnabled () const |
KJS::Interpreter * | jScriptInterpreter () |
QString | jsDefaultStatusBarText () const |
QString | jsStatusBarText () const |
KHTMLPart (KHTMLView *view, QObject *parent=0, GUIProfile prof=DefaultGUI) | |
KHTMLPart (QWidget *parentWidget=0, QObject *parent=0, GUIProfile prof=DefaultGUI) | |
QString | lastModified () const |
bool | metaRefreshEnabled () const |
bool | nextAnchor () |
DOM::Node | nodeUnderMouse () const |
DOM::Node | nonSharedNodeUnderMouse () const |
bool | onlyLocalReferences () const |
virtual bool | openUrl (const KUrl &url) |
QString | pageReferrer () const |
void | paint (QPainter *, const QRect &, int=0, bool *=0) |
KHTMLPart * | parentPart () |
KParts::PartManager * | partManager () |
bool | pluginsEnabled () const |
void | preloadScript (const QString &url, const QString &script) |
void | preloadStyleSheet (const QString &url, const QString &stylesheet) |
bool | prevAnchor () |
QString | referrer () const |
bool | restored () const |
virtual void | restoreState (QDataStream &stream) |
virtual void | saveState (QDataStream &stream) |
void | scheduleRedirection (int delay, const QString &url, bool lockHistory=true) |
void | selectAll () |
virtual QString | selectedText () const |
QString | selectedTextAsHTML () const |
void | selection (DOM::Node &startNode, long &startOffset, DOM::Node &endNode, long &endOffset) const |
DOM::Range | selection () const |
void | setAlwaysHonourDoctype (bool b=true) |
void | setAutoloadImages (bool enable) |
void | setCaretDisplayPolicyNonFocused (CaretDisplayPolicy policy) |
void | setCaretPosition (DOM::Node node, long offset, bool extendSelection=false) |
void | setDNDEnabled (bool b) |
void | setDNSPrefetch (DNSPrefetch pmode) |
bool | setEncoding (const QString &name, bool override=false) |
void | setFixedFont (const QString &name) |
void | setFontScaleFactor (int percent) |
void | setFormNotification (FormNotification fn) |
void | setJavaEnabled (bool enable) |
void | setJScriptEnabled (bool enable) |
void | setJSDefaultStatusBarText (const QString &text) |
void | setJSStatusBarText (const QString &text) |
void | setMetaRefreshEnabled (bool enable) |
void | setOnlyLocalReferences (bool enable) |
void | setPluginsEnabled (bool enable) |
void | setSelection (const DOM::Range &) |
void | setStandardFont (const QString &name) |
void | setStatusMessagesEnabled (bool enable) |
void | setSuppressedPopupIndicator (bool enable, KHTMLPart *originPart=0) |
const KHTMLSettings * | settings () const |
void | setURLCursor (const QCursor &c) |
void | setUserStyleSheet (const QString &styleSheet) |
void | setUserStyleSheet (const KUrl &url) |
void | setZoomFactor (int percent) |
void | show () |
virtual void | showError (KJob *job) |
bool | statusMessagesEnabled () const |
KUrl | toplevelURL () |
QCursor | urlCursor () const |
KHTMLView * | view () const |
virtual void | write (const QString &str) |
virtual void | write (const char *str, int len=-1) |
int | zoomFactor () const |
virtual | ~KHTMLPart () |
Protected Types | |
enum | PageSecurity { NotCrypted, Encrypted, Mixed } |
Protected Slots | |
virtual void | slotFinished (KJob *) |
Protected Member Functions | |
KUrl | completeURL (const QString &url) |
virtual KParts::ReadOnlyPart * | createPart (QWidget *parentWidget, QObject *parent, const QString &mimetype, QString &serviceName, QStringList &serviceTypes, const QStringList ¶ms) |
virtual void | customEvent (QEvent *event) |
virtual bool | doCloseStream () |
virtual bool | doOpenStream (const QString &mimeType) |
virtual bool | doWriteStream (const QByteArray &data) |
virtual void | guiActivateEvent (KParts::GUIActivateEvent *event) |
void | htmlError (int errorCode, const QString &text, const KUrl &reqUrl) |
virtual void | khtmlDrawContentsEvent (khtml::DrawContentsEvent *) |
virtual void | khtmlMouseDoubleClickEvent (khtml::MouseDoubleClickEvent *) |
virtual void | khtmlMouseMoveEvent (khtml::MouseMoveEvent *event) |
virtual void | khtmlMousePressEvent (khtml::MousePressEvent *event) |
virtual void | khtmlMouseReleaseEvent (khtml::MouseReleaseEvent *event) |
bool | mayPrefetchHostname (const QString &name) |
virtual bool | openFile () |
bool | pluginPageQuestionAsked (const QString &mimetype) const |
void | setPageSecurity (PageSecurity sec) |
void | setPluginPageQuestionAsked (const QString &mimetype) |
virtual void | startingJob (KIO::Job *) |
virtual void | timerEvent (QTimerEvent *) |
virtual bool | urlSelected (const QString &url, int button, int state, const QString &_target, const KParts::OpenUrlArguments &args=KParts::OpenUrlArguments(), const KParts::BrowserArguments &browserArgs=KParts::BrowserArguments()) |
Properties | |
bool | dndEnabled |
DNSPrefetch | dnsPrefetch |
QString | encoding |
bool | javaEnabled |
bool | javaScriptEnabled |
QString | lastModified |
bool | metaRefreshEnabled |
bool | modified |
bool | pluginsEnabled |
Detailed Description
This class is khtml's main class.It features an almost complete web browser, and html renderer.
The easiest way to use this class (if you just want to display an HTML page at some URL) is the following:
KUrl url = "http://www.kde.org"; KHTMLPart *w = new KHTMLPart(); w->openUrl(url); w->view()->resize(500, 400); w->show();
Java and JavaScript are enabled by default depending on the user's settings. If you do not need them, and especially if you display unfiltered data from untrusted sources, it is strongly recommended to turn them off. In that case, you should also turn off the automatic redirect and plugins:
w->setJScriptEnabled(false); w->setJavaEnabled(false); w->setMetaRefreshEnabled(false); w->setPluginsEnabled(false);
You may also wish to disable external references. This will prevent KHTML from loading images, frames, etc, or redirecting to external sites.
w->setOnlyLocalReferences(true);
Some apps want to write their HTML code directly into the widget instead of opening an url. You can do this in the following way:
QString myHTMLCode = ...; KHTMLPart *w = new KHTMLPart(); w->begin(); w->write(myHTMLCode); ... w->end();
You can do as many calls to write() as you wish. There are two write() methods, one accepting a QString and one accepting a char
*
argument. You should use one or the other (but not both) since the method using the char
*
argument does an additional decoding step to convert the written data to Unicode.
It is also possible to write content to the HTML part using the standard streaming API from KParts::ReadOnlyPart. The usage of the API is similar to that of the begin(), write(), end() process described above as the following example shows:
KHTMLPart *doc = new KHTMLPart(); doc->openStream( "text/html", KUrl() ); doc->writeStream( QCString( "<html><body><p>KHTML Rocks!</p></body></html>" ) ); doc->closeStream();
HTML Browser Widget
Definition at line 203 of file khtml_part.h.
Member Enumeration Documentation
Enumeration for displaying the caret.
- Enumerator:
-
CaretVisible caret is displayed CaretInvisible caret is not displayed CaretBlink caret toggles between visible and invisible
Definition at line 561 of file khtml_part.h.
DNS Prefetching Mode enumeration.
- DNSPrefetchDisabled do not prefetch hostnames
- DNSPrefetchEnabled always prefetch hostnames
- DNSPrefetchOnlyWWWAndSLD only do DNS prefetching for bare SLD and www sub-domain
Definition at line 275 of file khtml_part.h.
Extra Find options that can be used when calling the extended findText().
Definition at line 762 of file khtml_part.h.
enum KHTMLPart::PageSecurity [protected] |
Constructor & Destructor Documentation
KHTMLPart::KHTMLPart | ( | QWidget * | parentWidget = 0 , |
|
QObject * | parent = 0 , |
|||
GUIProfile | prof = DefaultGUI | |||
) |
Constructs a new KHTMLPart.
KHTML basically consists of two objects: The KHTMLPart itself, holding the document data (DOM document), and the KHTMLView, derived from QScrollArea, in which the document content is rendered in. You can specify two different parent objects for a KHTMLPart, one parent for the KHTMLPart document and one parent for the KHTMLView. If the second parent
argument is 0L, then parentWidget
is used as parent for both objects, the part and the view.
Definition at line 226 of file khtml_part.cpp.
KHTMLPart::KHTMLPart | ( | KHTMLView * | view, | |
QObject * | parent = 0 , |
|||
GUIProfile | prof = DefaultGUI | |||
) |
Constructs a new KHTMLPart.
This constructor is useful if you wish to subclass KHTMLView. If the view
passed as first argument to the constructor was built with a null KHTMLPart pointer, then the newly created KHTMLPart will be assigned as the view's part.
Therefore, you might either initialize the view as part of the initialization list of your derived KHTMLPart class constructor:
MyKHTMLPart() : KHTMLPart( new MyKHTMLView( this ), ...
KHTMLView * v = KHTMLView( 0L, parentWidget()); KHTMLPart * p = KHTMLPart( v ); // p will be assigned to v, so that v->part() == p
Definition at line 235 of file khtml_part.cpp.
KHTMLPart::~KHTMLPart | ( | ) | [virtual] |
Member Function Documentation
DOM::Node KHTMLPart::activeNode | ( | ) | const |
bool KHTMLPart::autoloadImages | ( | ) | const |
Returns whether images contained in the document are loaded automatically or not.
- Note:
- that the returned information is unrelieable as long as no begin() was called.
Definition at line 1485 of file khtml_part.cpp.
KUrl KHTMLPart::backgroundURL | ( | ) | const |
Returns the URL for the background Image (used by save background).
Definition at line 3852 of file khtml_part.cpp.
KUrl KHTMLPart::baseURL | ( | ) | const |
Definition at line 2463 of file khtml_part.cpp.
void KHTMLPart::begin | ( | const KUrl & | url = KUrl() , |
|
int | xOffset = 0 , |
|||
int | yOffset = 0 | |||
) | [virtual] |
Clears the widget and prepares it for new content.
If you want url() to return for example "file:/tmp/test.html", you can use the following code:
view->begin( KUrl("file:/tmp/test.html" ) );
- Parameters:
-
url is the url of the document to be displayed. Even if you are generating the HTML on the fly, it may be useful to specify a directory so that any pixmaps are found. xOffset is the initial horizontal scrollbar value. Usually you don't want to use this. yOffset is the initial vertical scrollbar value. Usually you don't want to use this.
Definition at line 1959 of file khtml_part.cpp.
KParts::BrowserExtension * KHTMLPart::browserExtension | ( | ) | const |
KParts::BrowserHostExtension * KHTMLPart::browserHostExtension | ( | ) | const |
Definition at line 1022 of file khtml_part.cpp.
KHTMLPart::CaretDisplayPolicy KHTMLPart::caretDisplayPolicyNonFocused | ( | ) | const |
Returns the current caret policy when the view is not focused.
Definition at line 2865 of file khtml_part.cpp.
void KHTMLPart::caretPositionChanged | ( | const DOM::Node & | node, | |
long | offset | |||
) | [signal] |
This signal is emitted whenever the caret position has been changed.
The signal transmits the position the DOM::Range way, the node and the zero-based offset within this node.
- Parameters:
-
node node which the caret is in. This can be null if the caret has been deactivated. offset offset within the node. If the node is null, the offset is meaningless.
bool KHTMLPart::closeUrl | ( | ) | [virtual] |
Stops loading the document and kills all data requests (for images, etc.
)
Definition at line 890 of file khtml_part.cpp.
KUrl KHTMLPart::completeURL | ( | const QString & | url | ) | [protected] |
returns a KUrl object for the given url.
Use when you know what you're doing.
Definition at line 2471 of file khtml_part.cpp.
void KHTMLPart::configurationChanged | ( | ) | [signal] |
Emitted whenever the configuration has changed.
KParts::ReadOnlyPart * KHTMLPart::createPart | ( | QWidget * | parentWidget, | |
QObject * | parent, | |||
const QString & | mimetype, | |||
QString & | serviceName, | |||
QStringList & | serviceTypes, | |||
const QStringList & | params | |||
) | [protected, virtual] |
This method is called when a new embedded object (include html frames) is to be created.
Reimplement it if you want to add support for certain embeddable objects without registering them in the KDE wide registry system (KSyCoCa) . Another reason for re-implementing this method could be if you want to derive from KTHMLPart and also want all html frame objects to be a object of your derived type, in which case you should return a new instance for the mimetype 'text/html' .
Definition at line 4446 of file khtml_part.cpp.
KParts::ReadOnlyPart * KHTMLPart::currentFrame | ( | ) | const |
Return the current frame (the one that has focus) Not necessarily a direct child of ours, framesets can be nested.
Returns "this" if this part isn't a frameset.
Definition at line 5086 of file khtml_part.cpp.
void KHTMLPart::customEvent | ( | QEvent * | event | ) | [protected, virtual] |
Definition at line 5855 of file khtml_part.cpp.
bool KHTMLPart::dndEnabled | ( | ) | const |
Returns whether Dragn'n'Drop support is enabled or not.
DNSPrefetch KHTMLPart::dnsPrefetch | ( | ) | const |
Returns currently set DNS prefetching mode.
See DNSPrefetch
enum for explanation of values.
- Note:
- Always returns
DNSPrefetchDisabled
if setOnlyLocalReferences() mode is enabled.
- Since:
- 4.2
void KHTMLPart::docCreated | ( | ) | [signal] |
For internal use only.
bool KHTMLPart::doCloseStream | ( | ) | [protected, virtual] |
Implements the streaming API of KParts::ReadOnlyPart.
Definition at line 2144 of file khtml_part.cpp.
DOM::Document KHTMLPart::document | ( | ) | const |
QString KHTMLPart::documentSource | ( | ) | const |
bool KHTMLPart::doOpenStream | ( | const QString & | mimeType | ) | [protected, virtual] |
Implements the streaming API of KParts::ReadOnlyPart.
Definition at line 2127 of file khtml_part.cpp.
bool KHTMLPart::doWriteStream | ( | const QByteArray & | data | ) | [protected, virtual] |
Implements the streaming API of KParts::ReadOnlyPart.
Definition at line 2138 of file khtml_part.cpp.
DOM::Editor * KHTMLPart::editor | ( | ) | const |
Returns the instance of the attached html editor interface.
Definition at line 3439 of file khtml_part.cpp.
QString KHTMLPart::encoding | ( | ) | const |
Returns the encoding the page currently uses.
Note that the encoding might be different from the charset.
void KHTMLPart::end | ( | ) | [virtual] |
Execute the specified snippet of JavaScript code.
Returns true
if JavaScript was enabled, no error occurred and the code returned true
itself or false
otherwise.
- Deprecated:
- , use executeString( DOM::Node(), script)
Definition at line 1333 of file khtml_part.cpp.
Same as executeScript( const QString & ) except with the Node parameter specifying the 'this' value.
Definition at line 1338 of file khtml_part.cpp.
Finds a frame by name.
Returns 0L if frame can't be found.
Definition at line 5067 of file khtml_part.cpp.
KHTMLPart * KHTMLPart::findFrameParent | ( | KParts::ReadOnlyPart * | callingPart, | |
const QString & | f, | |||
khtml::ChildFrame ** | childFrame = 0 | |||
) |
Recursively finds the part containing the frame with name f
and checks if it is accessible by callingPart
Returns 0L if no suitable frame can't be found.
Returns parent part if a suitable frame was found and frame info in *childFrame
Definition at line 5026 of file khtml_part.cpp.
KParts::ReadOnlyPart * KHTMLPart::findFramePart | ( | const QString & | f | ) |
Finds a frame by name.
Returns 0L if frame can't be found.
Definition at line 5080 of file khtml_part.cpp.
void KHTMLPart::findText | ( | const QString & | str, | |
long | options, | |||
QWidget * | parent = 0 , |
|||
KFindDialog * | findDialog = 0 | |||
) |
Starts a new search, but bypasses the user dialog.
- Parameters:
-
str The string to search for. options Find options. parent Parent used for centering popups like "string not found". findDialog Optionally, you can supply your own dialog.
Definition at line 3009 of file khtml_part.cpp.
void KHTMLPart::findText | ( | ) |
Starts a new search by popping up a dialog asking the user what he wants to search for.
Definition at line 3002 of file khtml_part.cpp.
void KHTMLPart::findTextBegin | ( | ) |
bool KHTMLPart::findTextNext | ( | bool | reverse = false |
) |
Finds the next occurrence of a string set by findText().
- Parameters:
-
reverse if true
, revert seach direction (only if no find dialog is used)
- Returns:
true
if a new match was found.
Definition at line 3017 of file khtml_part.cpp.
int KHTMLPart::fontScaleFactor | ( | ) | const |
KHTMLPart::FormNotification KHTMLPart::formNotification | ( | ) | const |
Determine if signal should be emitted before, instead or never when a submitForm() happens.
### KDE5 remove me
Definition at line 7025 of file khtml_part.cpp.
void KHTMLPart::formSubmitNotification | ( | const char * | action, | |
const QString & | url, | |||
const QByteArray & | formData, | |||
const QString & | target, | |||
const QString & | contentType, | |||
const QString & | boundary | |||
) | [signal] |
If form notification is on, this will be emitted either for a form submit or before the form submit according to the setting.
### KDE4 remove me
bool KHTMLPart::frameExists | ( | const QString & | frameName | ) |
Returns whether a frame with the specified name is exists or not.
In contrast to the findFrame method this one also returns true
if the frame is defined but no displaying component has been found/loaded, yet.
Definition at line 5101 of file khtml_part.cpp.
KJSProxy * KHTMLPart::framejScript | ( | KParts::ReadOnlyPart * | framePart | ) |
Returns child frame framePart its script interpreter.
Definition at line 5113 of file khtml_part.cpp.
QStringList KHTMLPart::frameNames | ( | ) | const |
Returns a list of names of all frame (including iframe) objects of the current document.
Note that this method is not working recursively for sub-frames.
Definition at line 5801 of file khtml_part.cpp.
QList< KParts::ReadOnlyPart * > KHTMLPart::frames | ( | ) | const |
Definition at line 5814 of file khtml_part.cpp.
bool KHTMLPart::gotoAnchor | ( | const QString & | name | ) |
Finds the anchor named name
.
If the anchor is found, the widget scrolls to the closest position. Returns if
the anchor has been found.
Definition at line 2655 of file khtml_part.cpp.
void KHTMLPart::guiActivateEvent | ( | KParts::GUIActivateEvent * | event | ) | [protected, virtual] |
Internal reimplementation of KParts::Part::guiActivateEvent .
Definition at line 6402 of file khtml_part.cpp.
bool KHTMLPart::hasSelection | ( | ) | const |
Has the user selected anything?
Call selectedText() to retrieve the selected text.
- Returns:
true
if there is text selected.
Definition at line 3198 of file khtml_part.cpp.
void KHTMLPart::hide | ( | ) |
Convenience method to hide the document's view.
Equivalent to widget()->hide() or view()->hide().
Definition at line 5461 of file khtml_part.cpp.
DOM::HTMLDocument KHTMLPart::htmlDocument | ( | ) | const |
Returns a reference to the DOM HTML document (for non-HTML documents, returns null).
Definition at line 972 of file khtml_part.cpp.
void KHTMLPart::htmlError | ( | int | errorCode, | |
const QString & | text, | |||
const KUrl & | reqUrl | |||
) | [protected] |
presents a detailed error message to the user.
errorCode
kio error code, eg KIO::ERR_SERVER_TIMEOUT. text
kio additional information text. url
the url that triggered the error.
Definition at line 1806 of file khtml_part.cpp.
bool KHTMLPart::inProgress | ( | ) | const |
bool KHTMLPart::isCaretMode | ( | ) | const |
bool KHTMLPart::isEditable | ( | ) | const |
Returns true
if the document is editable, false
otherwise.
Definition at line 2842 of file khtml_part.cpp.
bool KHTMLPart::isModified | ( | ) | const |
Checks whether the page contains unsubmitted form changes.
- Returns:
true
if form changes exist
Definition at line 7041 of file khtml_part.cpp.
bool KHTMLPart::isPointInsideSelection | ( | int | x, | |
int | y | |||
) |
Returns whether the given point is inside the current selection.
The coordinates are content-coordinates.
Definition at line 5890 of file khtml_part.cpp.
bool KHTMLPart::javaEnabled | ( | ) | const |
Return true
if Java applet support is enabled, false
if disabled.
bool KHTMLPart::jScriptEnabled | ( | ) | const |
Returns true
if Javascript support is enabled or false
otherwise.
Definition at line 1074 of file khtml_part.cpp.
KJS::Interpreter * KHTMLPart::jScriptInterpreter | ( | ) |
Returns the JavaScript interpreter the part is using.
This method is mainly intended for applications which embed and extend the part and provides a mechanism for adding additional native objects to the interpreter (or removing the built-ins).
One thing people using this method to add things to the interpreter must consider, is that when you start writing new content to the part, the interpreter is cleared. This includes both use of the begin( const KUrl &, int, int ) method, and the openUrl( const KUrl & ) method. If you want your objects to have a longer lifespan, then you must retain a KJS::Object yourself to ensure that the reference count of your custom objects never reaches 0. You will also need to re-add your bindings every time this happens - one way to detect the need for this is to connect to the docCreated() signal, another is to reimplement the begin() method.
Definition at line 1051 of file khtml_part.cpp.
QString KHTMLPart::jsDefaultStatusBarText | ( | ) | const |
Called by KJS.
Returns the DefaultStatusBarText assigned via window.defaultStatus
Definition at line 5704 of file khtml_part.cpp.
QString KHTMLPart::jsStatusBarText | ( | ) | const |
Called by KJS.
Returns the StatusBarText assigned via window.status
Definition at line 5699 of file khtml_part.cpp.
void KHTMLPart::khtmlDrawContentsEvent | ( | khtml::DrawContentsEvent * | ) | [protected, virtual] |
void KHTMLPart::khtmlMouseDoubleClickEvent | ( | khtml::MouseDoubleClickEvent * | event | ) | [protected, virtual] |
void KHTMLPart::khtmlMouseMoveEvent | ( | khtml::MouseMoveEvent * | event | ) | [protected, virtual] |
void KHTMLPart::khtmlMousePressEvent | ( | khtml::MousePressEvent * | event | ) | [protected, virtual] |
void KHTMLPart::khtmlMouseReleaseEvent | ( | khtml::MouseReleaseEvent * | event | ) | [protected, virtual] |
QString KHTMLPart::lastModified | ( | ) | const |
Last-modified date (in raw string format), if received in the [HTTP] headers.
bool KHTMLPart::mayPrefetchHostname | ( | const QString & | name | ) | [protected] |
Will pre-resolve name
according to dnsPrefetch current settings Returns true
if the name will be pre-resolved.
Otherwise returns false.
Definition at line 3399 of file khtml_part.cpp.
bool KHTMLPart::metaRefreshEnabled | ( | ) | const |
Returns true
if automatic forwarding is enabled.
bool KHTMLPart::nextAnchor | ( | ) |
Go to the next anchor.
This is useful to navigate from outside the navigator
Definition at line 2703 of file khtml_part.cpp.
void KHTMLPart::nodeActivated | ( | const DOM::Node & | ) | [signal] |
This signal is emitted when an element retrieves the keyboard focus.
Note that the signal argument can be a null node if no element is active, meaning a node has explicitly been deactivated without a new one becoming active.
DOM::Node KHTMLPart::nodeUnderMouse | ( | ) | const |
Returns the Node
currently under the mouse.
The returned node may be a shared node (e. g. an <area> node if the mouse is hovering over an image map).
Definition at line 5467 of file khtml_part.cpp.
DOM::Node KHTMLPart::nonSharedNodeUnderMouse | ( | ) | const |
Returns the Node
currently under the mouse that is not shared.
The returned node is always the node that is physically under the mouse pointer (irrespective of logically overlying elements like, e. g., <area> on image maps).
Definition at line 5472 of file khtml_part.cpp.
bool KHTMLPart::onlyLocalReferences | ( | ) | const |
Returns whether only file:/ or data:/ references are allowed to be loaded ( default false
).
See setOnlyLocalReferences.
Definition at line 2741 of file khtml_part.cpp.
void KHTMLPart::onURL | ( | const QString & | url | ) | [signal] |
Emitted if the cursor is moved over an URL.
bool KHTMLPart::openFile | ( | ) | [protected, virtual] |
Internal empty reimplementation of KParts::ReadOnlyPart::openFile .
Definition at line 1632 of file khtml_part.cpp.
bool KHTMLPart::openUrl | ( | const KUrl & | url | ) | [virtual] |
Opens the specified URL url
.
Reimplemented from KParts::ReadOnlyPart::openUrl .
The format of the error url is that two variables are passed in the query: error = int kio error code, errText = QString error text from kio and the URL where the error happened is passed as a sub URL.
Definition at line 663 of file khtml_part.cpp.
QString KHTMLPart::pageReferrer | ( | ) | const |
Paints the HTML page to a QPainter.
See KHTMLView::paint for details
Definition at line 2151 of file khtml_part.cpp.
KHTMLPart * KHTMLPart::parentPart | ( | ) |
Returns a pointer to the parent KHTMLPart if the part is a frame in an HTML frameset.
Returns 0L otherwise.
Definition at line 5131 of file khtml_part.cpp.
KParts::PartManager * KHTMLPart::partManager | ( | ) |
Returns a reference to the partmanager instance which manages html frame objects.
Definition at line 4499 of file khtml_part.cpp.
bool KHTMLPart::pluginPageQuestionAsked | ( | const QString & | mimetype | ) | const [protected] |
Definition at line 6756 of file khtml_part.cpp.
bool KHTMLPart::pluginsEnabled | ( | ) | const |
Returns true
if plugins are enabled, false
if disabled.
Emitted when the user clicks the right mouse button on the document.
See KParts::BrowserExtension for two more popupMenu signals emitted by khtml, with much more information in the signal.
bool KHTMLPart::prevAnchor | ( | ) |
QString KHTMLPart::referrer | ( | ) | const |
bool KHTMLPart::restored | ( | ) | const |
void KHTMLPart::restoreState | ( | QDataStream & | stream | ) | [virtual] |
Restores the KHTMLPart's previously saved state (including child frame objects) from the provided QDataStream.
- See also:
- saveState()
Definition at line 5257 of file khtml_part.cpp.
void KHTMLPart::saveState | ( | QDataStream & | stream | ) | [virtual] |
Saves the KHTMLPart's complete state (including child frame objects) to the provided QDataStream.
This is called from the saveState() method of the browserExtension().
Definition at line 5169 of file khtml_part.cpp.
void KHTMLPart::scheduleRedirection | ( | int | delay, | |
const QString & | url, | |||
bool | lockHistory = true | |||
) |
void KHTMLPart::selectAll | ( | ) |
QString KHTMLPart::selectedText | ( | ) | const [virtual] |
QString KHTMLPart::selectedTextAsHTML | ( | ) | const |
Return the text the user has marked.
This is guaranteed to be valid xml, and to contain the <html> and <body> tags.
FIXME probably should make virtual for 4.0 ?
Definition at line 3024 of file khtml_part.cpp.
void KHTMLPart::selection | ( | DOM::Node & | startNode, | |
long & | startOffset, | |||
DOM::Node & | endNode, | |||
long & | endOffset | |||
) | const |
Returns the selected part of the HTML by returning the starting and end position.
If there is no selection, both nodes and offsets are equal.
- Parameters:
-
startNode returns node selection starts in startOffset returns offset within starting node endNode returns node selection ends in endOffset returns offset within end node.
Definition at line 3208 of file khtml_part.cpp.
DOM::Range KHTMLPart::selection | ( | ) | const |
void KHTMLPart::selectionChanged | ( | ) | [signal] |
This signal is emitted when the selection changes.
void KHTMLPart::setActiveNode | ( | const DOM::Node & | node | ) | [slot] |
Sets the focused node of the document to the specified node.
If the node is a form control, the control will receive focus in the same way that it would if the user had clicked on it or tabbed to it with the keyboard. For most other types of elements, there is no visual indication of whether or not they are focused.
See activeNode
- Parameters:
-
node The node to focus
Definition at line 6687 of file khtml_part.cpp.
void KHTMLPart::setAlwaysHonourDoctype | ( | bool | b = true |
) |
Sets whether the document's Doctype should always be used to determine the parsing mode for the document.
Without this, parsing will be forced to strict mode when using the write( const QString &str ) method for backward compatibility reasons.
Definition at line 2074 of file khtml_part.cpp.
void KHTMLPart::setAutoloadImages | ( | bool | enable | ) |
Specifies whether images contained in the document should be loaded automatically or not.
- Note:
- Request will be ignored if called before begin().
Definition at line 1457 of file khtml_part.cpp.
void KHTMLPart::setCaretDisplayPolicyNonFocused | ( | CaretDisplayPolicy | policy | ) |
Sets the caret display policy when the view is not focused.
Whenever the caret is in use, this property determines how the caret should be displayed when the document view is not focused.
The default policy is CaretInvisible.
- Parameters:
-
policy new display policy
Definition at line 2877 of file khtml_part.cpp.
void KHTMLPart::setCaretMode | ( | bool | enable | ) | [slot] |
Enables/disables caret mode.
Enabling caret mode displays a caret which can be used to navigate the document using the keyboard only. Caret mode is switched off by default.
- Parameters:
-
enable true
to enable,false
to disable caret mode.
Definition at line 2805 of file khtml_part.cpp.
void KHTMLPart::setCaretPosition | ( | DOM::Node | node, | |
long | offset, | |||
bool | extendSelection = false | |||
) |
Sets the caret to the given position.
If the given location is invalid, it will snap to the nearest valid location. Immediately afterwards a caretPositionChanged
signal containing the effective position is emitted
- Parameters:
-
node node to set to offset zero-based offset within the node extendSelection If true
, a selection will be spanned from the last caret position to the given one. Otherwise, any existing selection will be deselected.
Definition at line 2851 of file khtml_part.cpp.
void KHTMLPart::setCaretVisible | ( | bool | show | ) | [slot] |
Sets the visibility of the caret.
This methods displays or hides the caret regardless of the current caret display policy (see setCaretDisplayNonFocused), and regardless of focus.
The caret will be shown/hidden only under at least one of the following conditions:
- the document is editable
- the document is in caret mode
- the document's currently focused element is editable
- Parameters:
-
show true
to make visible,false
to hide.
Definition at line 2886 of file khtml_part.cpp.
void KHTMLPart::setDNDEnabled | ( | bool | b | ) |
Enables or disables Drag'n'Drop support.
A drag operation is started if the users drags a link.
Definition at line 5845 of file khtml_part.cpp.
void KHTMLPart::setDNSPrefetch | ( | DNSPrefetch | pmode | ) |
Sets whether DNS Names found in loaded documents'anchors should be pre-fetched (pre-resolved).
Note that calling this function will permanently override the User settings about DNS prefetch support. Not calling this function is the only way to let the default settings apply.
- Note:
- This setting has no effect if setOnlyLocalReferences() mode is enabled.
- Parameters:
-
pmode the mode to set. See DNSPrefetch enum for explanation of values.
- Since:
- 4.2
Definition at line 1083 of file khtml_part.cpp.
void KHTMLPart::setEditable | ( | bool | enable | ) | [slot] |
Makes the document editable.
Setting this property to true
makes the document, and its subdocuments (such as frames, iframes, objects) editable as a whole. FIXME: insert more information about navigation, features etc. as seen fit
- Parameters:
-
enable true
to set document editable,false
to set it read-only.
Definition at line 2827 of file khtml_part.cpp.
bool KHTMLPart::setEncoding | ( | const QString & | name, | |
bool | override = false | |||
) |
Sets the encoding the page uses.
This can be different from the charset. The widget will try to reload the current page in the new encoding, if url() is not empty.
Definition at line 2601 of file khtml_part.cpp.
void KHTMLPart::setFixedFont | ( | const QString & | name | ) |
Sets the fixed font style.
- Parameters:
-
name The font name to use for fixed text, e.g. the <pre>
tag.
Definition at line 2726 of file khtml_part.cpp.
void KHTMLPart::setFontScaleFactor | ( | int | percent | ) |
Sets the scale factor to be applied to fonts.
The value is given in percent, larger values mean generally larger fonts.
The given value should be in the range of 20..300, values outside that range are not guaranteed to work. A value of 100 will disable all scaling of font sizes and show the page with the sizes determined via the given lengths in the stylesheets.
Definition at line 5628 of file khtml_part.cpp.
void KHTMLPart::setFormNotification | ( | KHTMLPart::FormNotification | fn | ) |
Determine if signal should be emitted before, instead or never when a submitForm() happens.
### KDE5 remove me
Definition at line 7021 of file khtml_part.cpp.
void KHTMLPart::setJavaEnabled | ( | bool | enable | ) |
Enables/disables Java applet support.
Note that calling this function will permanently override the User settings about Java applet support. Not calling this function is the only way to let the default settings apply.
Definition at line 1376 of file khtml_part.cpp.
void KHTMLPart::setJScriptEnabled | ( | bool | enable | ) |
Enable/disable Javascript support.
Note that this will in either case permanently override the default usersetting. If you want to have the default UserSettings, don't call this method.
Definition at line 1065 of file khtml_part.cpp.
void KHTMLPart::setJSDefaultStatusBarText | ( | const QString & | text | ) |
Called by KJS.
Sets the DefaultStatusBarText assigned via window.defaultStatus
Definition at line 5694 of file khtml_part.cpp.
void KHTMLPart::setJSStatusBarText | ( | const QString & | text | ) |
Called by KJS.
Sets the StatusBarText assigned via window.status
Definition at line 5689 of file khtml_part.cpp.
void KHTMLPart::setMetaRefreshEnabled | ( | bool | enable | ) |
Enable/disable automatic forwarding by <meta http-equiv="refresh" .
...>
Definition at line 1096 of file khtml_part.cpp.
void KHTMLPart::setOnlyLocalReferences | ( | bool | enable | ) |
Security option.
Specify whether only file:/ or data:/ urls are allowed to be loaded without user confirmation by KHTML. ( for example referenced by stylesheets, images, scripts, subdocuments, embedded elements ).
This option is mainly intended for enabling the "mail reader mode", where you load untrusted content with a file:/ url.
Please note that enabling this option currently automatically disables Javascript, Java and Plugins support. This might change in the future if the security model is becoming more sophisticated, so don't rely on this behaviour.
( default false
- everything is loaded unless forbidden by KApplication::authorizeURLAction).
Definition at line 2746 of file khtml_part.cpp.
void KHTMLPart::setPageSecurity | ( | PageSecurity | sec | ) | [protected] |
Definition at line 1659 of file khtml_part.cpp.
void KHTMLPart::setPluginPageQuestionAsked | ( | const QString & | mimetype | ) | [protected] |
Definition at line 6766 of file khtml_part.cpp.
void KHTMLPart::setPluginsEnabled | ( | bool | enable | ) |
void KHTMLPart::setSelection | ( | const DOM::Range & | r | ) |
void KHTMLPart::setStandardFont | ( | const QString & | name | ) |
Sets the standard font style.
- Parameters:
-
name The font name to use for standard text.
Definition at line 2721 of file khtml_part.cpp.
void KHTMLPart::setStatusMessagesEnabled | ( | bool | enable | ) |
Enable/disable statusbar messages.
When this class wants to set the statusbar text, it emits setStatusBarText(const QString & text) If you want to catch this for your own statusbar, note that it returns back a rich text string, starting with "<qt>". This you need to either pass this into your own QLabel or to strip out the tags before passing it to QStatusBar::message(const QString & message)
- See also:
- KParts::Part::setStatusBarText( const QString & text )
Definition at line 1046 of file khtml_part.cpp.
void KHTMLPart::setSuppressedPopupIndicator | ( | bool | enable, | |
KHTMLPart * | originPart = 0 | |||
) |
const KHTMLSettings * KHTMLPart::settings | ( | ) | const |
void KHTMLPart::setURLCursor | ( | const QCursor & | c | ) |
Sets the cursor to use when the cursor is on a link.
Definition at line 2731 of file khtml_part.cpp.
void KHTMLPart::setUserStyleSheet | ( | const QString & | styleSheet | ) |
Sets a user defined style sheet to be used on top of the HTML 4 default style sheet.
This gives a wide range of possibilities to change the layout of the page.
To have an effect this function has to be called after calling begin().
Definition at line 2649 of file khtml_part.cpp.
void KHTMLPart::setUserStyleSheet | ( | const KUrl & | url | ) |
Sets a user defined style sheet to be used on top of the HTML 4 default style sheet.
This gives a wide range of possibilities to change the layout of the page.
To have an effect this function has to be called after calling begin().
Definition at line 2643 of file khtml_part.cpp.
void KHTMLPart::setZoomFactor | ( | int | percent | ) |
Sets the Zoom factor.
The value is given in percent, larger values mean a generally larger font and larger page contents.
The given value should be in the range of 20..300, values outside that range are not guaranteed to work. A value of 100 will disable all zooming and show the page with the sizes determined via the given lengths in the stylesheets.
Definition at line 5549 of file khtml_part.cpp.
void KHTMLPart::show | ( | ) |
Convenience method to show the document's view.
Equivalent to widget()->show() or view()->show() .
Definition at line 5455 of file khtml_part.cpp.
void KHTMLPart::showError | ( | KJob * | job | ) | [virtual] |
Called when a certain error situation (i.e.
connection timed out) occurred. The default implementation either shows a KIO error dialog or loads a more verbose error description a as page, depending on the users configuration. job
is the job that signaled the error situation
Definition at line 1789 of file khtml_part.cpp.
void KHTMLPart::slotFinished | ( | KJob * | job | ) | [protected, virtual, slot] |
Called when the job downloading the page is finished.
Can be reimplemented, for instance to get metadata out of the job, but make sure to call KHTMLPart::slotFinished() too.
Definition at line 1902 of file khtml_part.cpp.
virtual void KHTMLPart::startingJob | ( | KIO::Job * | ) | [inline, protected, virtual] |
Hook for adding code before a job is started.
This can be used to add metadata, like job->addMetaData("PropagateHttpHeader", "true") to get the HTTP headers.
Definition at line 1374 of file khtml_part.h.
bool KHTMLPart::statusMessagesEnabled | ( | ) | const |
void KHTMLPart::stopAnimations | ( | ) | [slot] |
Stops all animated images on the current and child pages.
Definition at line 2157 of file khtml_part.cpp.
void KHTMLPart::submitFormProxy | ( | const char * | action, | |
const QString & | url, | |||
const QByteArray & | formData, | |||
const QString & | target, | |||
const QString & | contentType = QString() , |
|||
const QString & | boundary = QString() | |||
) | [slot] |
Definition at line 4525 of file khtml_part.cpp.
void KHTMLPart::timerEvent | ( | QTimerEvent * | e | ) | [protected, virtual] |
KUrl KHTMLPart::toplevelURL | ( | ) |
Returns the toplevel (origin) URL of this document, even if this part is a frame or an iframe.
- Returns:
- the actual original url.
Definition at line 7029 of file khtml_part.cpp.
QCursor KHTMLPart::urlCursor | ( | ) | const |
Returns the cursor which is used when the cursor is on a link.
Definition at line 2736 of file khtml_part.cpp.
bool KHTMLPart::urlSelected | ( | const QString & | url, | |
int | button, | |||
int | state, | |||
const QString & | _target, | |||
const KParts::OpenUrlArguments & | args = KParts::OpenUrlArguments() , |
|||
const KParts::BrowserArguments & | browserArgs = KParts::BrowserArguments() | |||
) | [protected, virtual] |
Definition at line 3629 of file khtml_part.cpp.
KHTMLView * KHTMLPart::view | ( | ) | const |
void KHTMLPart::write | ( | const QString & | str | ) | [virtual] |
Writes another part of the HTML code to the widget.
You may call this function many times in sequence. But remember: The fewer calls you make, the faster the widget will be.
For historic and backward compatibility reasons, this method will force the use of strict mode for the document, unless setAlwaysHonourDoctype() has been called previously.
Definition at line 2079 of file khtml_part.cpp.
void KHTMLPart::write | ( | const char * | str, | |
int | len = -1 | |||
) | [virtual] |
Writes another part of the HTML code to the widget.
You may call this function many times in sequence. But remember: The fewer calls you make, the faster the widget will be.
The HTML code is send through a decoder which decodes the stream to Unicode.
The len
parameter is needed for streams encoded in utf-16, since these can have \0 chars in them. In case the encoding you're using isn't utf-16, you can safely leave out the length parameter.
Attention: Don't mix calls to write( const char *) with calls to write( const QString & ).
The result might not be what you want.
Definition at line 2049 of file khtml_part.cpp.
int KHTMLPart::zoomFactor | ( | ) | const |
Property Documentation
bool KHTMLPart::dndEnabled [read, write] |
Definition at line 251 of file khtml_part.h.
KHTMLPart::DNSPrefetch KHTMLPart::dnsPrefetch [read, write] |
Definition at line 253 of file khtml_part.h.
QString KHTMLPart::encoding [read, write] |
Definition at line 261 of file khtml_part.h.
bool KHTMLPart::javaEnabled [read, write] |
Definition at line 250 of file khtml_part.h.
bool KHTMLPart::javaScriptEnabled [read, write] |
Definition at line 249 of file khtml_part.h.
QString KHTMLPart::lastModified [read] |
Definition at line 262 of file khtml_part.h.
bool KHTMLPart::metaRefreshEnabled [read, write] |
Definition at line 263 of file khtml_part.h.
bool KHTMLPart::modified [read] |
Definition at line 260 of file khtml_part.h.
bool KHTMLPart::pluginsEnabled [read, write] |
Definition at line 252 of file khtml_part.h.
The documentation for this class was generated from the following files: