.TH "KHTMLPart" kde3 "11 Jun 2005" "Version Version 3.4.1" "khtml Library" \" -*- nroff -*-
.ad l
.nh
.SH NAME
KHTMLPart \- This class is khtml's main class. HTML Browser Widget.  

.PP
.SH SYNOPSIS
.br
.PP
\fC#include <khtml_part.h>\fP
.PP
Inherits \fBKParts::ReadOnlyPart\fP.
.PP
.SS "Public Types"

.in +1c
.ti -1c
.RI "enum \fBGUIProfile\fP { \fBDefaultGUI\fP, \fBBrowserViewGUI\fP }"
.br
.ti -1c
.RI "enum \fBCaretDisplayPolicy\fP { \fBCaretVisible\fP, \fBCaretInvisible\fP, \fBCaretBlink\fP }"
.br
.ti -1c
.RI "enum \fBFindOptions\fP { \fBFindLinksOnly\fP =  1 * KFindDialog::MinimumUserOption, \fBFindNoPopups\fP =  2 * KFindDialog::MinimumUserOption }"
.br
.ti -1c
.RI "enum \fBFormNotification\fP { \fBNoNotification\fP =  0, \fBBefore\fP, \fBOnly\fP, \fBUnused\fP = 255 }"
.br
.in -1c
.SS "Public Slots"

.in +1c
.ti -1c
.RI "void \fBsetActiveNode\fP (const \fBDOM::Node\fP &node)"
.br
.ti -1c
.RI "void \fBstopAnimations\fP ()"
.br
.ti -1c
.RI "\fBQCString\fP \fBdcopObjectId\fP () const "
.br
.ti -1c
.RI "\fBQVariant\fP \fBexecuteScript\fP (const \fBQString\fP &script)"
.br
.ti -1c
.RI "void \fBsetCaretMode\fP (bool enable)"
.br
.ti -1c
.RI "void \fBsetEditable\fP (bool enable)"
.br
.ti -1c
.RI "void \fBsetCaretVisible\fP (bool show)"
.br
.ti -1c
.RI "void \fBsubmitFormProxy\fP (const char *\fBaction\fP, const \fBQString\fP &\fBurl\fP, const \fBQByteArray\fP &formData, const \fBQString\fP &target, const \fBQString\fP &contentType=QString::null, const \fBQString\fP &boundary=QString::null)"
.br
.in -1c
.SS "Signals"

.in +1c
.ti -1c
.RI "void \fBonURL\fP (const \fBQString\fP &\fBurl\fP)"
.br
.ti -1c
.RI "void \fBpopupMenu\fP (const \fBQString\fP &\fBurl\fP, const \fBQPoint\fP &point)"
.br
.ti -1c
.RI "void \fBselectionChanged\fP ()"
.br
.ti -1c
.RI "void \fBnodeActivated\fP (const \fBDOM::Node\fP &)"
.br
.ti -1c
.RI "void \fBdocCreated\fP ()"
.br
.ti -1c
.RI "void \fBcaretPositionChanged\fP (const \fBDOM::Node\fP &node, long offset)"
.br
.ti -1c
.RI "void \fBformSubmitNotification\fP (const char *\fBaction\fP, const \fBQString\fP &\fBurl\fP, const \fBQByteArray\fP &formData, const \fBQString\fP &target, const \fBQString\fP &contentType, const \fBQString\fP &boundary)"
.br
.in -1c
.SS "Public Member Functions"

.in +1c
.ti -1c
.RI "\fBKHTMLPart\fP (\fBQWidget\fP *parentWidget=0, const char *widgetname=0, \fBQObject\fP *\fBparent\fP=0, const char *\fBname\fP=0, GUIProfile prof=DefaultGUI)"
.br
.ti -1c
.RI "\fBKHTMLPart\fP (\fBKHTMLView\fP *view, \fBQObject\fP *\fBparent\fP=0, const char *\fBname\fP=0, GUIProfile prof=DefaultGUI)"
.br
.ti -1c
.RI "virtual \fB~KHTMLPart\fP ()"
.br
.ti -1c
.RI "virtual bool \fBopenURL\fP (const \fBKURL\fP &\fBurl\fP)"
.br
.ti -1c
.RI "virtual bool \fBcloseURL\fP ()"
.br
.ti -1c
.RI "virtual void \fBshowError\fP (\fBKIO::Job\fP *job)"
.br
.ti -1c
.RI "\fBDOM::HTMLDocument\fP \fBhtmlDocument\fP () const "
.br
.ti -1c
.RI "\fBDOM::Document\fP \fBdocument\fP () const "
.br
.ti -1c
.RI "\fBQString\fP \fBdocumentSource\fP () const "
.br
.ti -1c
.RI "\fBDOM::Node\fP \fBactiveNode\fP () const "
.br
.ti -1c
.RI "\fBKParts::BrowserExtension\fP * \fBbrowserExtension\fP () const "
.br
.ti -1c
.RI "\fBKParts::LiveConnectExtension\fP * \fBliveConnectExtension\fP (const khtml::RenderPart *) const "
.br
.ti -1c
.RI "\fBKParts::BrowserHostExtension\fP * \fBbrowserHostExtension\fP () const "
.br
.ti -1c
.RI "\fBKHTMLView\fP * \fBview\fP () const "
.br
.ti -1c
.RI "void \fBsetJScriptEnabled\fP (bool enable)"
.br
.ti -1c
.RI "bool \fBjScriptEnabled\fP () const "
.br
.ti -1c
.RI "KJS::Interpreter * \fBjScriptInterpreter\fP ()"
.br
.ti -1c
.RI "void \fBsetStatusMessagesEnabled\fP (bool enable)"
.br
.ti -1c
.RI "bool \fBstatusMessagesEnabled\fP () const "
.br
.ti -1c
.RI "void \fBsetMetaRefreshEnabled\fP (bool enable)"
.br
.ti -1c
.RI "bool \fBmetaRefreshEnabled\fP () const "
.br
.ti -1c
.RI "\fBQVariant\fP \fBexecuteScript\fP (const \fBDOM::Node\fP &n, const \fBQString\fP &script)"
.br
.ti -1c
.RI "void \fBsetDNDEnabled\fP (bool b)"
.br
.ti -1c
.RI "bool \fBdndEnabled\fP () const "
.br
.ti -1c
.RI "void \fBsetJavaEnabled\fP (bool enable)"
.br
.ti -1c
.RI "bool \fBjavaEnabled\fP () const "
.br
.ti -1c
.RI "\fBKJavaAppletContext\fP * \fBjavaContext\fP ()"
.br
.ti -1c
.RI "\fBKJavaAppletContext\fP * \fBcreateJavaContext\fP ()"
.br
.ti -1c
.RI "void \fBsetPluginsEnabled\fP (bool enable)"
.br
.ti -1c
.RI "bool \fBpluginsEnabled\fP () const "
.br
.ti -1c
.RI "void \fBsetAutoloadImages\fP (bool enable)"
.br
.ti -1c
.RI "bool \fBautoloadImages\fP () const "
.br
.ti -1c
.RI "void \fBsetOnlyLocalReferences\fP (bool enable)"
.br
.ti -1c
.RI "bool \fBonlyLocalReferences\fP () const "
.br
.ti -1c
.RI "bool \fBisCaretMode\fP () const "
.br
.ti -1c
.RI "bool \fBisEditable\fP () const "
.br
.ti -1c
.RI "void \fBsetCaretPosition\fP (\fBDOM::Node\fP node, long offset, bool extendSelection=false)"
.br
.ti -1c
.RI "\fBCaretDisplayPolicy\fP \fBcaretDisplayPolicyNonFocused\fP () const "
.br
.ti -1c
.RI "void \fBsetCaretDisplayPolicyNonFocused\fP (\fBCaretDisplayPolicy\fP policy)"
.br
.ti -1c
.RI "void \fBenableJScript\fP (bool e)"
.br
.ti -1c
.RI "void \fBenableJava\fP (bool e)"
.br
.ti -1c
.RI "void \fBenablePlugins\fP (bool e)"
.br
.ti -1c
.RI "void \fBautoloadImages\fP (bool e)"
.br
.ti -1c
.RI "void \fBenableMetaRefresh\fP (bool e)"
.br
.ti -1c
.RI "bool \fBsetCharset\fP (const \fBQString\fP &, bool)"
.br
.ti -1c
.RI "\fBKURL\fP \fBbaseURL\fP () const "
.br
.ti -1c
.RI "\fBQString\fP \fBbaseTarget\fP () const "
.br
.ti -1c
.RI "\fBKURL\fP \fBbackgroundURL\fP () const "
.br
.ti -1c
.RI "void \fBscheduleRedirection\fP (int delay, const \fBQString\fP &\fBurl\fP, bool lockHistory=true)"
.br
.ti -1c
.RI "virtual void \fBbegin\fP (const \fBKURL\fP &\fBurl\fP=\fBKURL\fP(), int xOffset=0, int yOffset=0)"
.br
.ti -1c
.RI "virtual void \fBwrite\fP (const char *str, int len=-1)"
.br
.ti -1c
.RI "virtual void \fBwrite\fP (const \fBQString\fP &str)"
.br
.ti -1c
.RI "virtual void \fBend\fP ()"
.br
.ti -1c
.RI "void \fBpaint\fP (\fBQPainter\fP *, const \fBQRect\fP &, int=0, bool *=0)"
.br
.ti -1c
.RI "bool \fBsetEncoding\fP (const \fBQString\fP &\fBname\fP, bool override=false)"
.br
.ti -1c
.RI "\fBQString\fP \fBencoding\fP () const "
.br
.ti -1c
.RI "void \fBsetUserStyleSheet\fP (const \fBKURL\fP &\fBurl\fP)"
.br
.ti -1c
.RI "void \fBsetUserStyleSheet\fP (const \fBQString\fP &styleSheet)"
.br
.ti -1c
.RI "void \fBsetStandardFont\fP (const \fBQString\fP &\fBname\fP)"
.br
.ti -1c
.RI "void \fBsetFixedFont\fP (const \fBQString\fP &\fBname\fP)"
.br
.ti -1c
.RI "bool \fBgotoAnchor\fP (const \fBQString\fP &\fBname\fP)"
.br
.ti -1c
.RI "bool \fBnextAnchor\fP ()"
.br
.ti -1c
.RI "bool \fBprevAnchor\fP ()"
.br
.ti -1c
.RI "void \fBsetURLCursor\fP (const \fBQCursor\fP &c)"
.br
.ti -1c
.RI "\fBQCursor\fP \fBurlCursor\fP () const "
.br
.ti -1c
.RI "void \fBfindText\fP ()"
.br
.ti -1c
.RI "void \fBfindText\fP (const \fBQString\fP &str, long options, \fBQWidget\fP *\fBparent\fP=0, KFindDialog *findDialog=0)"
.br
.ti -1c
.RI "void \fBfindTextBegin\fP ()"
.br
.ti -1c
.RI "bool \fBfindTextNext\fP (const \fBQString\fP &str, bool forward, bool caseSensitive, bool isRegExp)"
.br
.ti -1c
.RI "bool \fBfindTextNext\fP ()"
.br
.ti -1c
.RI "void \fBsetZoomFactor\fP (int percent)"
.br
.ti -1c
.RI "int \fBzoomFactor\fP () const "
.br
.ti -1c
.RI "virtual \fBQString\fP \fBselectedText\fP () const "
.br
.ti -1c
.RI "\fBQString\fP \fBselectedTextAsHTML\fP () const "
.br
.ti -1c
.RI "DOM::Range \fBselection\fP () const "
.br
.ti -1c
.RI "void \fBselection\fP (\fBDOM::Node\fP &startNode, long &startOffset, \fBDOM::Node\fP &endNode, long &endOffset) const "
.br
.ti -1c
.RI "void \fBsetSelection\fP (const DOM::Range &)"
.br
.ti -1c
.RI "bool \fBhasSelection\fP () const "
.br
.ti -1c
.RI "void \fBselectAll\fP ()"
.br
.ti -1c
.RI "void \fBshow\fP ()"
.br
.ti -1c
.RI "void \fBhide\fP ()"
.br
.ti -1c
.RI "\fBKParts::PartManager\fP * \fBpartManager\fP ()"
.br
.ti -1c
.RI "virtual void \fBsaveState\fP (\fBQDataStream\fP &stream)"
.br
.ti -1c
.RI "virtual void \fBrestoreState\fP (\fBQDataStream\fP &stream)"
.br
.ti -1c
.RI "\fBDOM::Node\fP \fBnodeUnderMouse\fP () const "
.br
.ti -1c
.RI "\fBDOM::Node\fP \fBnonSharedNodeUnderMouse\fP () const "
.br
.ti -1c
.RI "const \fBKHTMLSettings\fP * \fBsettings\fP () const "
.br
.ti -1c
.RI "\fBKHTMLPart\fP * \fBparentPart\fP ()"
.br
.ti -1c
.RI "\fBQStringList\fP \fBframeNames\fP () const "
.br
.ti -1c
.RI "\fBQPtrList\fP< \fBKParts::ReadOnlyPart\fP > \fBframes\fP () const "
.br
.ti -1c
.RI "\fBKHTMLPart\fP * \fBfindFrame\fP (const \fBQString\fP &f)"
.br
.ti -1c
.RI "\fBKHTMLPart\fP * \fBfindFrameParent\fP (\fBKParts::ReadOnlyPart\fP *callingPart, const \fBQString\fP &f, khtml::ChildFrame **childFrame=0)"
.br
.ti -1c
.RI "\fBKParts::ReadOnlyPart\fP * \fBcurrentFrame\fP () const "
.br
.ti -1c
.RI "bool \fBframeExists\fP (const \fBQString\fP &frameName)"
.br
.ti -1c
.RI "KJSProxy * \fBframejScript\fP (\fBKParts::ReadOnlyPart\fP *framePart)"
.br
.ti -1c
.RI "\fBKParts::ReadOnlyPart\fP * \fBfindFramePart\fP (const \fBQString\fP &f)"
.br
.ti -1c
.RI "void \fBsetJSStatusBarText\fP (const \fBQString\fP &text)"
.br
.ti -1c
.RI "void \fBsetJSDefaultStatusBarText\fP (const \fBQString\fP &text)"
.br
.ti -1c
.RI "\fBQString\fP \fBjsStatusBarText\fP () const "
.br
.ti -1c
.RI "\fBQString\fP \fBjsDefaultStatusBarText\fP () const "
.br
.ti -1c
.RI "\fBQString\fP \fBreferrer\fP () const "
.br
.ti -1c
.RI "\fBQString\fP \fBpageReferrer\fP () const "
.br
.ti -1c
.RI "\fBQString\fP \fBlastModified\fP () const "
.br
.ti -1c
.RI "void \fBpreloadStyleSheet\fP (const \fBQString\fP &\fBurl\fP, const \fBQString\fP &stylesheet)"
.br
.ti -1c
.RI "void \fBpreloadScript\fP (const \fBQString\fP &\fBurl\fP, const \fBQString\fP &script)"
.br
.ti -1c
.RI "bool \fBrestored\fP () const "
.br
.ti -1c
.RI "void \fBsetFormNotification\fP (FormNotification fn)"
.br
.ti -1c
.RI "FormNotification \fBformNotification\fP () const "
.br
.ti -1c
.RI "\fBKURL\fP \fBtoplevelURL\fP ()"
.br
.ti -1c
.RI "bool \fBisModified\fP () const "
.br
.ti -1c
.RI "void \fBsetSuppressedPopupIndicator\fP (bool enable)"
.br
.in -1c
.SS "Protected Types"

.in +1c
.ti -1c
.RI "enum \fBPageSecurity\fP { \fBNotCrypted\fP, \fBEncrypted\fP, \fBMixed\fP }"
.br
.in -1c
.SS "Protected Member Functions"

.in +1c
.ti -1c
.RI "\fBKURL\fP \fBcompleteURL\fP (const \fBQString\fP &\fBurl\fP)"
.br
.ti -1c
.RI "void \fBhtmlError\fP (int errorCode, const \fBQString\fP &text, const \fBKURL\fP &reqUrl)"
.br
.ti -1c
.RI "virtual void \fBcustomEvent\fP (\fBQCustomEvent\fP *\fBevent\fP)"
.br
.ti -1c
.RI "virtual void \fBkhtmlMousePressEvent\fP (khtml::MousePressEvent *\fBevent\fP)"
.br
.ti -1c
.RI "virtual void \fBkhtmlMouseDoubleClickEvent\fP (khtml::MouseDoubleClickEvent *)"
.br
.ti -1c
.RI "virtual void \fBkhtmlMouseMoveEvent\fP (khtml::MouseMoveEvent *\fBevent\fP)"
.br
.ti -1c
.RI "virtual void \fBkhtmlMouseReleaseEvent\fP (khtml::MouseReleaseEvent *\fBevent\fP)"
.br
.ti -1c
.RI "virtual void \fBkhtmlDrawContentsEvent\fP (khtml::DrawContentsEvent *)"
.br
.ti -1c
.RI "virtual void \fBguiActivateEvent\fP (\fBKParts::GUIActivateEvent\fP *\fBevent\fP)"
.br
.ti -1c
.RI "virtual bool \fBopenFile\fP ()"
.br
.ti -1c
.RI "virtual void \fBurlSelected\fP (const \fBQString\fP &\fBurl\fP, int button, int state, const \fBQString\fP &_target, \fBKParts::URLArgs\fP args=\fBKParts::URLArgs\fP())"
.br
.ti -1c
.RI "virtual \fBKParts::ReadOnlyPart\fP * \fBcreatePart\fP (\fBQWidget\fP *parentWidget, const char *widgetName, \fBQObject\fP *\fBparent\fP, const char *\fBname\fP, const \fBQString\fP &mimetype, \fBQString\fP &serviceName, \fBQStringList\fP &serviceTypes, const \fBQStringList\fP &params)"
.br
.ti -1c
.RI "bool \fBpluginPageQuestionAsked\fP (const \fBQString\fP &mimetype) const "
.br
.ti -1c
.RI "void \fBsetPluginPageQuestionAsked\fP (const \fBQString\fP &mimetype)"
.br
.ti -1c
.RI "void \fBsetPageSecurity\fP (PageSecurity sec)"
.br
.ti -1c
.RI "virtual bool \fBdoOpenStream\fP (const \fBQString\fP &mimeType)"
.br
.ti -1c
.RI "virtual bool \fBdoWriteStream\fP (const \fBQByteArray\fP &data)"
.br
.ti -1c
.RI "virtual bool \fBdoCloseStream\fP ()"
.br
.in -1c
.SS "Properties"

.in +1c
.ti -1c
.RI "bool \fBjavaScriptEnabled\fP"
.br
.ti -1c
.RI "bool \fBjavaEnabled\fP"
.br
.ti -1c
.RI "bool \fBautoloadImages\fP"
.br
.ti -1c
.RI "bool \fBdndEnabled\fP"
.br
.ti -1c
.RI "bool \fBpluginsEnabled\fP"
.br
.ti -1c
.RI "bool \fBonlyLocalReferences\fP"
.br
.ti -1c
.RI "\fBQCString\fP \fBdcopObjectId\fP"
.br
.ti -1c
.RI "bool \fBmodified\fP"
.br
.in -1c
.SS "Friends"

.in +1c
.ti -1c
.RI "class \fBKHTMLView\fP"
.br
.ti -1c
.RI "class \fBDOM::HTMLTitleElementImpl\fP"
.br
.ti -1c
.RI "class \fBDOM::HTMLFrameElementImpl\fP"
.br
.ti -1c
.RI "class \fBDOM::HTMLIFrameElementImpl\fP"
.br
.ti -1c
.RI "class \fBDOM::HTMLObjectElementImpl\fP"
.br
.ti -1c
.RI "class \fBDOM::HTMLAnchorElementImpl\fP"
.br
.ti -1c
.RI "class \fBDOM::HTMLMetaElementImpl\fP"
.br
.ti -1c
.RI "class \fBDOM::NodeImpl\fP"
.br
.ti -1c
.RI "class \fBKHTMLRun\fP"
.br
.ti -1c
.RI "class \fBDOM::HTMLFormElementImpl\fP"
.br
.ti -1c
.RI "class \fBkhtml::RenderPartObject\fP"
.br
.ti -1c
.RI "class \fBKJS::Window\fP"
.br
.ti -1c
.RI "class \fBKJS::ScheduledAction\fP"
.br
.ti -1c
.RI "class \fBKJS::JSNodeFilter\fP"
.br
.ti -1c
.RI "class \fBKJS::WindowFunc\fP"
.br
.ti -1c
.RI "class \fBKJS::ExternalFunc\fP"
.br
.ti -1c
.RI "class \fBKJS::JSEventListener\fP"
.br
.ti -1c
.RI "class \fBKJS::JSLazyEventListener\fP"
.br
.ti -1c
.RI "class \fBKJS::DOMDocument\fP"
.br
.ti -1c
.RI "class \fBKJS::SourceFile\fP"
.br
.ti -1c
.RI "class \fBKJSProxy\fP"
.br
.ti -1c
.RI "class \fBKHTMLPartBrowserExtension\fP"
.br
.ti -1c
.RI "class \fBDOM::DocumentImpl\fP"
.br
.ti -1c
.RI "class \fBDOM::HTMLDocumentImpl\fP"
.br
.ti -1c
.RI "class \fBKHTMLPartBrowserHostExtension\fP"
.br
.ti -1c
.RI "class \fBkhtml::HTMLTokenizer\fP"
.br
.ti -1c
.RI "class \fBkhtml::XMLTokenizer\fP"
.br
.ti -1c
.RI "class \fBkhtml::RenderWidget\fP"
.br
.ti -1c
.RI "class \fBkhtml::CSSStyleSelector\fP"
.br
.ti -1c
.RI "class \fBKHTMLPartIface\fP"
.br
.ti -1c
.RI "class \fBKHTMLPartFunction\fP"
.br
.ti -1c
.RI "class \fBKHTMLPartPrivate\fP"
.br
.in -1c
.SH "Detailed Description"
.PP 
This class is khtml's main class. HTML Browser Widget. 

It features an almost complete web browser, and html renderer.
.PP
The easiest way to use this class (if you just want to display an HTML page at some URL) is the following:
.PP
.PP
.nf
 KURL url = 'http://www.kde.org';
 KHTMLPart *w = new KHTMLPart();
 w->openURL(url);
 w->view()->resize(500, 400);
 w->show();
.fi
.PP
.PP
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:
.PP
.PP
.nf
 w->setJScriptEnabled(false);
 w->setJavaEnabled(false);
 w->setMetaRefreshEnabled(false);
 w->setPluginsEnabled(false);
.fi
.PP
.PP
You may also wish to disable external references. This will prevent KHTML from loading images, frames, etc, or redirecting to external sites.
.PP
.PP
.nf
 w->setOnlyLocalReferences(true);
.fi
.PP
.PP
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:
.PP
.PP
.nf
 QString myHTMLCode = ...;
 KHTMLPart *w = new KHTMLPart();
 w->begin();
 w->write(myHTMLCode);
 ...
 w->end();
.fi
.PP
.PP
You can do as many calls to \fBwrite()\fP as you wish. There are two \fBwrite()\fP methods, one accepting a \fBQString\fP and one accepting a \fCchar\fP \fC*\fP argument. You should use one or the other (but not both) since the method using the \fCchar\fP \fC*\fP argument does an additional decoding step to convert the written data to Unicode.
.PP
It is also possible to write content to the HTML part using the standard streaming API from \fBKParts::ReadOnlyPart\fP. The usage of the API is similar to that of the \fBbegin()\fP, \fBwrite()\fP, \fBend()\fP process described above as the following example shows:
.PP
.PP
.nf
 KHTMLPart *doc = new KHTMLPart();
 doc->openStream( 'text/html', KURL() );
 doc->writeStream( QCString( '<html><body><p>KHTML Rocks!</p></body></html>' ) );
 doc->closeStream();
.fi
.PP
.PP
\fBAuthor:\fP
.RS 4
Lars Knoll (knoll@kde.org) 
.RE
.PP

.PP
Definition at line 184 of file khtml_part.h.
.SH "Member Enumeration Documentation"
.PP 
.SS "enum \fBKHTMLPart::CaretDisplayPolicy\fP"
.PP
Enumeration for displaying the caret. 
.PP
\fBParameters:\fP
.RS 4
\fIVisible\fP caret is displayed 
.br
\fIInvisible\fP caret is not displayed 
.br
\fIBlink\fP caret toggles between visible and invisible 
.RE
.PP
\fBSince:\fP
.RS 4
3.2 
.RE
.PP

.PP
Definition at line 482 of file khtml_part.h.
.SS "enum \fBKHTMLPart::FindOptions\fP"
.PP
Extra Find options that can be used when calling the extended \fBfindText()\fP. 
.PP
\fBSince:\fP
.RS 4
3.3 
.RE
.PP

.PP
Definition at line 685 of file khtml_part.h.
.SH "Constructor & Destructor Documentation"
.PP 
.SS "KHTMLPart::KHTMLPart (\fBQWidget\fP * parentWidget = \fC0\fP, const char * widgetname = \fC0\fP, \fBQObject\fP * parent = \fC0\fP, const char * name = \fC0\fP, GUIProfile prof = \fCDefaultGUI\fP)"
.PP
Constructs a new KHTMLPart. 
.PP
KHTML basically consists of two objects: The KHTMLPart itself, holding the document data (\fBDOM\fP document), and the \fBKHTMLView\fP, derived from \fBQScrollView\fP, 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 on parent for the \fBKHTMLView\fP. If the second \fCparent\fP argument is 0L, then \fCparentWidget\fP is used as parent for both objects, the part and the view. 
.PP
Definition at line 204 of file khtml_part.cpp.
.SS "KHTMLPart::~\fBKHTMLPart\fP ()\fC [virtual]\fP"
.PP
Destructor. 
.PP
Definition at line 448 of file khtml_part.cpp.
.PP
References closeURL(), KGlobal::config(), QObject::disconnect(), parentPart(), KConfigBase::setGroup(), and KConfigBase::writeEntry().
.SH "Member Function Documentation"
.PP 
.SS "bool KHTMLPart::openURL (const \fBKURL\fP & url)\fC [virtual]\fP"
.PP
Opens the specified URL \fCurl\fP. 
.PP
Reimplemented from \fBKParts::ReadOnlyPart::openURL\fP . 
.PP
Reimplemented from \fBKParts::ReadOnlyPart\fP.
.PP
Definition at line 546 of file khtml_part.cpp.
.PP
References QToolTip::add(), KProtocolManager::cacheControl(), closeURL(), KParts::ReadOnlyPart::completed(), QObject::connect(), QValueList::count(), QObject::disconnect(), endl(), QValueList::first(), KIO::get(), gotoAnchor(), KURL::host(), htmlError(), KIO::http_post(), KXMLGUIClient::instance(), QString::isEmpty(), KURL::join(), kdDebug(), parentPart(), KURL::path(), QValueList::pop_front(), KURL::prettyURL(), KURL::protocol(), KURL::queryItem(), QToolTip::remove(), KURL::setPath(), KURL::split(), KParts::ReadOnlyPart::started(), QString::startsWith(), KIO::stat(), QString::toInt(), toplevelURL(), KParts::ReadOnlyPart::url(), KURL::url(), KProtocolManager::userAgentForHost(), and KParts::Part::widget().
.PP
Referenced by restoreState(), and setEncoding().
.SS "bool KHTMLPart::closeURL ()\fC [virtual]\fP"
.PP
Stops loading the document and kills all data requests (for images, etc.). 
.PP
Reimplemented from \fBKParts::ReadOnlyPart\fP.
.PP
Definition at line 750 of file khtml_part.cpp.
.PP
References KProtocolManager::cacheControl(), KHTMLPageCache::cancelEntry(), KHTMLPageCache::cancelFetch(), QObject::disconnect(), end(), endl(), kdDebug(), nodeActivated(), KURL::prettyURL(), and KHTMLPageCache::self().
.PP
Referenced by openURL(), restoreState(), setEncoding(), and ~KHTMLPart().
.SS "void KHTMLPart::showError (\fBKIO::Job\fP * job)\fC [virtual]\fP"
.PP
Called when a certain error situation (i.e. 
.PP
connection timed out) occurred. The default implementation either shows a \fBKIO\fP error dialog or loads a more verbose error description a as page, depending on the users configuration. \fCjob\fP is the job that signaled the error situation 
.PP
Definition at line 1659 of file khtml_part.cpp.
.PP
References endl(), htmlError(), and kdDebug().
.SS "\fBDOM::HTMLDocument\fP KHTMLPart::htmlDocument () const"
.PP
Returns a reference to the \fBDOM\fP HTML document (for non-HTML documents, returns null). 
.PP
Definition at line 832 of file khtml_part.cpp.
.SS "\fBDOM::Document\fP KHTMLPart::document () const"
.PP
Returns a reference to the \fBDOM\fP document. 
.PP
Definition at line 840 of file khtml_part.cpp.
.PP
Referenced by selection().
.SS "\fBQString\fP KHTMLPart::documentSource () const"
.PP
Returns the content of the source document. 
.PP
\fBSince:\fP
.RS 4
3.4 
.RE
.PP

.PP
Definition at line 845 of file khtml_part.cpp.
.PP
References QFile::close(), KIO::NetAccess< T, K >::download(), encoding(), KHTMLPageCache::isComplete(), KURL::isLocalFile(), QFile::open(), QTextStream::read(), KIO::NetAccess< T, K >::removeTempFile(), KHTMLPageCache::saveData(), KHTMLPageCache::self(), and QTextStream::setCodec().
.SS "\fBDOM::Node\fP KHTMLPart::activeNode () const"
.PP
Returns the node that has the keyboard focus. 
.PP
Definition at line 6668 of file khtml_part.cpp.
.SS "\fBKParts::BrowserExtension\fP * KHTMLPart::browserExtension () const"
.PP
Returns a pointer to the \fBKParts::BrowserExtension\fP. 
.PP
Definition at line 877 of file khtml_part.cpp.
.SS "\fBKHTMLView\fP * KHTMLPart::view () const"
.PP
Returns a pointer to the HTML document's view. 
.PP
Definition at line 887 of file khtml_part.cpp.
.PP
Referenced by caretDisplayPolicyNonFocused(), findTextNext(), khtmlMouseMoveEvent(), setCaretDisplayPolicyNonFocused(), setCaretMode(), setCaretPosition(), setCaretVisible(), and setEditable().
.SS "void KHTMLPart::setJScriptEnabled (bool enable)"
.PP
Enable/disable Javascript support. 
.PP
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. 
.PP
Definition at line 911 of file khtml_part.cpp.
.PP
References KHTMLView::clear(), and jScriptEnabled().
.SS "bool KHTMLPart::jScriptEnabled () const"
.PP
Returns \fCtrue\fP if Javascript support is enabled or \fCfalse\fP otherwise. 
.PP
Definition at line 920 of file khtml_part.cpp.
.PP
References onlyLocalReferences().
.PP
Referenced by setJScriptEnabled().
.SS "KJS::Interpreter * KHTMLPart::jScriptInterpreter ()"
.PP
Returns the JavaScript interpreter the part is using. 
.PP
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).
.PP
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 \fBbegin( const KURL &, int, int )\fP method, and the \fBopenURL( const KURL & )\fP 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 everytime this happens - one way to detect the need for this is to connect to the docCreated() signal, another is to reimplement the \fBbegin()\fP method. 
.PP
Definition at line 897 of file khtml_part.cpp.
.SS "void KHTMLPart::setStatusMessagesEnabled (bool enable)"
.PP
Enable/disable statusbar messages. 
.PP
Definition at line 892 of file khtml_part.cpp.
.SS "bool KHTMLPart::statusMessagesEnabled () const"
.PP
Returns \fCtrue\fP if status messages are enabled. 
.PP
Definition at line 906 of file khtml_part.cpp.
.SS "void KHTMLPart::setMetaRefreshEnabled (bool enable)"
.PP
Enable/disable automatic forwarding by <meta http-equiv='refresh' ....>. 
.PP
Definition at line 929 of file khtml_part.cpp.
.SS "bool KHTMLPart::metaRefreshEnabled () const"
.PP
Returns \fCtrue\fP if automatic forwarding is enabled. 
.PP
Definition at line 934 of file khtml_part.cpp.
.SS "\fBQVariant\fP KHTMLPart::executeScript (const \fBDOM::Node\fP & n, const \fBQString\fP & script)"
.PP
Same as \fBexecuteScript( const QString & )\fP except with the Node parameter specifying the 'this' value. 
.PP
Definition at line 1161 of file khtml_part.cpp.
.PP
References endl(), kdDebug(), QObject::name(), and QVariant::toString().
.PP
Referenced by executeScript().
.SS "void KHTMLPart::setDNDEnabled (bool b)"
.PP
Enables or disables Drag'n'Drop support. 
.PP
A drag operation is started if the users drags a link. 
.PP
Definition at line 5709 of file khtml_part.cpp.
.SS "bool KHTMLPart::dndEnabled () const"
.PP
Returns whether Dragn'n'Drop support is enabled or not. 
.PP
.SS "void KHTMLPart::setJavaEnabled (bool enable)"
.PP
Enables/disables Java applet support. 
.PP
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. 
.PP
Definition at line 1219 of file khtml_part.cpp.
.SS "bool KHTMLPart::javaEnabled () const"
.PP
Return true if Java applet support is enabled, false if disabled. 
.PP
.SS "\fBKJavaAppletContext\fP * KHTMLPart::javaContext ()"
.PP
Returns the java context of the applets. 
.PP
If no applet exists, 0 is returned. 
.PP
Definition at line 1238 of file khtml_part.cpp.
.SS "\fBKJavaAppletContext\fP * KHTMLPart::createJavaContext ()"
.PP
Returns the java context of the applets. 
.PP
If no context exists yet, a new one is created. 
.PP
Definition at line 1243 of file khtml_part.cpp.
.SS "void KHTMLPart::setPluginsEnabled (bool enable)"
.PP
Enables or disables plugins, default is enabled. 
.PP
Definition at line 1248 of file khtml_part.cpp.
.SS "bool KHTMLPart::pluginsEnabled () const"
.PP
Returns true if plugins are enabled/disabled. 
.PP
.SS "void KHTMLPart::setAutoloadImages (bool enable)"
.PP
Specifies whether images contained in the document should be loaded automatically or not. 
.PP
\fBNote:\fP
.RS 4
Request will be ignored if called before \fBbegin()\fP. 
.RE
.PP

.PP
Definition at line 1310 of file khtml_part.cpp.
.PP
References KXMLGUIClient::actionCollection(), QPtrList::append(), KXMLGUIClient::plugActionList(), and KXMLGUIClient::unplugActionList().
.PP
Referenced by begin().
.SS "bool KHTMLPart::autoloadImages () const"
.PP
Returns whether images contained in the document are loaded automatically or not. 
.PP
\fBNote:\fP
.RS 4
that the returned information is unrelieable as long as no \fBbegin()\fP was called. 
.RE
.PP

.SS "void KHTMLPart::setOnlyLocalReferences (bool enable)"
.PP
Security option. 
.PP
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 ).
.PP
This option is mainly intended for enabling the 'mail reader mode', where you load untrusted content with a file:/ url.
.PP
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.
.PP
( default false - everything is loaded unless forbidden by \fBKApplication::authorizeURLAction\fP). 
.PP
Definition at line 2545 of file khtml_part.cpp.
.SS "bool KHTMLPart::onlyLocalReferences () const"
.PP
Returns whether only file:/ or data:/ references are allowed to be loaded ( default false ). 
.PP
\fBSee also:\fP
.RS 4
\fBsetOnlyLocalReferences\fP. 
.RE
.PP

.PP
Referenced by jScriptEnabled().
.SS "bool KHTMLPart::isCaretMode () const"
.PP
Returns whether caret mode is on/off. 
.PP
\fBSince:\fP
.RS 4
3.2 
.RE
.PP

.PP
Definition at line 2595 of file khtml_part.cpp.
.PP
Referenced by KHTMLView::layout(), setCaretMode(), setCaretVisible(), and setEditable().
.SS "bool KHTMLPart::isEditable () const"
.PP
Returns \fCtrue\fP if the document is editable, \fCfalse\fP otherwise. 
.PP
\fBSince:\fP
.RS 4
3.2 
.RE
.PP

.PP
Definition at line 2616 of file khtml_part.cpp.
.PP
Referenced by khtmlMouseMoveEvent(), khtmlMousePressEvent(), KHTMLView::layout(), setCaretMode(), setCaretVisible(), and setEditable().
.SS "void KHTMLPart::setCaretPosition (\fBDOM::Node\fP node, long offset, bool extendSelection = \fCfalse\fP)"
.PP
Sets the caret to the given position. 
.PP
If the given location is invalid, it will snap to the nearest valid location. Immediately afterwards a \fCcaretPositionChanged\fP signal containing the effective position is emitted 
.PP
\fBParameters:\fP
.RS 4
\fInode\fP node to set to 
.br
\fIoffset\fP zero-based offset within the node 
.br
\fIextendSelection\fP If \fCtrue\fP, a selection will be spanned from the last caret position to the given one. Otherwise, any existing selection will be deselected. 
.RE
.PP
\fBSince:\fP
.RS 4
3.2 
.RE
.PP

.PP
Definition at line 2621 of file khtml_part.cpp.
.PP
References endl(), KHTMLView::ensureCaretVisible(), DOM::Node::handle(), k_funcinfo, kdDebug(), DOM::Node::nodeName(), DOM::DOMString::string(), and view().
.SS "\fBKHTMLPart::CaretDisplayPolicy\fP KHTMLPart::caretDisplayPolicyNonFocused () const"
.PP
Returns the current caret policy when the view is not focused. 
.PP
\fBSince:\fP
.RS 4
3.2 
.RE
.PP

.PP
Definition at line 2635 of file khtml_part.cpp.
.PP
References KHTMLView::caretDisplayPolicyNonFocused(), and view().
.SS "void KHTMLPart::setCaretDisplayPolicyNonFocused (\fBCaretDisplayPolicy\fP policy)"
.PP
Sets the caret display policy when the view is not focused. 
.PP
Whenever the caret is in use, this property determines how the caret should be displayed when the document view is not focused.
.PP
The default policy is CaretInvisible. 
.PP
\fBParameters:\fP
.RS 4
\fIpolicy\fP new display policy 
.RE
.PP
\fBSince:\fP
.RS 4
3.2 
.RE
.PP

.PP
Definition at line 2644 of file khtml_part.cpp.
.PP
References KHTMLView::setCaretDisplayPolicyNonFocused(), and view().
.SS "\fBKURL\fP KHTMLPart::backgroundURL () const"
.PP
Returns the URL for the background Image (used by save background). 
.PP
Definition at line 3908 of file khtml_part.cpp.
.SS "void KHTMLPart::scheduleRedirection (int delay, const \fBQString\fP & url, bool lockHistory = \fCtrue\fP)"
.PP
Schedules a redirection after \fCdelay\fP seconds. 
.PP
Definition at line 2323 of file khtml_part.cpp.
.PP
References endl(), and kdDebug().
.SS "void KHTMLPart::begin (const \fBKURL\fP & url = \fC\fBKURL\fP()\fP, int xOffset = \fC0\fP, int yOffset = \fC0\fP)\fC [virtual]\fP"
.PP
Clears the widget and prepares it for new content. 
.PP
If you want \fBurl()\fP to return for example 'file:/tmp/test.html', you can use the following code: 
.PP
.nf
 view->begin( KURL('file:/tmp/test.html' ) );

.fi
.PP
.PP
\fBParameters:\fP
.RS 4
\fIurl\fP 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.
.br
\fIxOffset\fP is the initial horizontal scrollbar value. Usually you don't want to use this.
.br
\fIyOffset\fP is the initial vertical scrollbar value. Usually you don't want to use this.
.RE
.PP
All child frames and the old document are removed if you call this method. 
.PP
Definition at line 1819 of file khtml_part.cpp.
.PP
References QObject::connect(), QString::isEmpty(), KMimeType::mimeType(), parentPart(), KURL::prettyURL(), KURL::protocol(), KURL::ref(), setAutoloadImages(), KURL::setQuery(), KURL::setRef(), setSuppressedPopupIndicator(), setUserStyleSheet(), KParts::Part::setWindowCaption(), QString::startsWith(), and KURL::url().
.PP
Referenced by doOpenStream(), framejScript(), and htmlError().
.SS "void KHTMLPart::write (const char * str, int len = \fC-1\fP)\fC [virtual]\fP"
.PP
Writes another part of the HTML code to the widget. 
.PP
You may call this function many times in sequence. But remember: The fewer calls you make, the faster the widget will be.
.PP
The HTML code is send through a decoder which decodes the stream to Unicode.
.PP
The \fClen\fP 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.
.PP
Attention: Don't mix calls to write( const char *) with calls to \fBwrite( const QString & )\fP.
.PP
The result might not be what you want. 
.PP
Definition at line 1909 of file khtml_part.cpp.
.PP
References QString::isEmpty().
.PP
Referenced by doWriteStream(), end(), and htmlError().
.SS "void KHTMLPart::write (const \fBQString\fP & str)\fC [virtual]\fP"
.PP
Writes another part of the HTML code to the widget. 
.PP
You may call this function many times in sequence. But remember: The fewer calls you make, the faster the widget will be. 
.PP
Definition at line 1941 of file khtml_part.cpp.
.SS "void KHTMLPart::end ()\fC [virtual]\fP"
.PP
Call this after your last call to \fBwrite()\fP. 
.PP
Definition at line 1956 of file khtml_part.cpp.
.PP
References write().
.PP
Referenced by closeURL(), doCloseStream(), framejScript(), htmlError(), and stopAnimations().
.SS "void KHTMLPart::paint (\fBQPainter\fP *, const \fBQRect\fP &, int = \fC0\fP, bool * = \fC0\fP)"
.PP
Paints the HTML page to a \fBQPainter\fP. 
.PP
See KHTMLView::paint for details 
.PP
Definition at line 1989 of file khtml_part.cpp.
.SS "bool KHTMLPart::setEncoding (const \fBQString\fP & name, bool override = \fCfalse\fP)"
.PP
Sets the encoding the page uses. 
.PP
This can be different from the charset. The widget will try to reload the current page in the new encoding, if \fBurl()\fP is not empty. 
.PP
Definition at line 2400 of file khtml_part.cpp.
.PP
References closeURL(), KURL::isEmpty(), and openURL().
.SS "\fBQString\fP KHTMLPart::encoding () const"
.PP
Returns the encoding the page currently uses. 
.PP
Note that the encoding might be different from the charset. 
.PP
Definition at line 2418 of file khtml_part.cpp.
.PP
Referenced by documentSource().
.SS "void KHTMLPart::setUserStyleSheet (const \fBKURL\fP & url)"
.PP
Sets a user defined style sheet to be used on top of the HTML 4 default style sheet. 
.PP
This gives a wide range of possibilities to change the layout of the page. 
.PP
Definition at line 2442 of file khtml_part.cpp.
.PP
Referenced by begin().
.SS "void KHTMLPart::setUserStyleSheet (const \fBQString\fP & styleSheet)"
.PP
Sets a user defined style sheet to be used on top of the HTML 4 default style sheet. 
.PP
This gives a wide range of possibilities to change the layout of the page. 
.PP
Definition at line 2448 of file khtml_part.cpp.
.SS "void KHTMLPart::setStandardFont (const \fBQString\fP & name)"
.PP
Sets the standard font style. 
.PP
\fBParameters:\fP
.RS 4
\fIname\fP The font name to use for standard text. 
.RE
.PP

.PP
Definition at line 2520 of file khtml_part.cpp.
.SS "void KHTMLPart::setFixedFont (const \fBQString\fP & name)"
.PP
Sets the fixed font style. 
.PP
\fBParameters:\fP
.RS 4
\fIname\fP The font name to use for fixed text, e.g. the \fC<pre>\fP tag. 
.RE
.PP

.PP
Definition at line 2525 of file khtml_part.cpp.
.SS "bool KHTMLPart::gotoAnchor (const \fBQString\fP & name)"
.PP
Finds the anchor named \fCname\fP. 
.PP
If the anchor is found, the widget scrolls to the closest position. Returns \fCif\fP the anchor has been found. 
.PP
Definition at line 2454 of file khtml_part.cpp.
.PP
References endl(), kdDebug(), and QString::ref().
.PP
Referenced by openURL().
.SS "bool KHTMLPart::nextAnchor ()"
.PP
Go to the next anchor. 
.PP
This is useful to navigate from outside the navigator 
.PP
\fBSince:\fP
.RS 4
3.2 
.RE
.PP

.PP
Definition at line 2502 of file khtml_part.cpp.
.SS "bool KHTMLPart::prevAnchor ()"
.PP
Go to previous anchor 
.PP
\fBSince:\fP
.RS 4
3.2. 
.RE
.PP

.PP
Definition at line 2511 of file khtml_part.cpp.
.SS "void KHTMLPart::setURLCursor (const \fBQCursor\fP & c)"
.PP
Sets the cursor to use when the cursor is on a link. 
.PP
Definition at line 2530 of file khtml_part.cpp.
.SS "\fBQCursor\fP KHTMLPart::urlCursor () const"
.PP
Returns the cursor which is used when the cursor is on a link. 
.PP
Definition at line 2535 of file khtml_part.cpp.
.SS "void KHTMLPart::findText ()"
.PP
Starts a new search by popping up a dialog asking the user what he wants to search for. 
.PP
\fBSince:\fP
.RS 4
3.3 
.RE
.PP

.PP
Definition at line 2867 of file khtml_part.cpp.
.PP
References QObject::connect(), QObject::disconnect(), hasSelection(), selectionChanged(), and KParts::Part::widget().
.PP
Referenced by findTextNext().
.SS "void KHTMLPart::findText (const \fBQString\fP & str, long options, \fBQWidget\fP * parent = \fC0\fP, KFindDialog * findDialog = \fC0\fP)"
.PP
Starts a new search, but bypasses the user dialog. 
.PP
\fBParameters:\fP
.RS 4
\fIstr\fP The string to search for. 
.br
\fIoptions\fP Find options. 
.br
\fIparent\fP Parent used for centering popups like 'string not found'. 
.br
\fIfindDialog\fP Optionally, you can supply your own dialog. 
.RE
.PP
\fBSince:\fP
.RS 4
3.3 
.RE
.PP

.PP
Definition at line 2905 of file khtml_part.cpp.
.PP
References QObject::connect(), and selectionChanged().
.SS "void KHTMLPart::findTextBegin ()"
.PP
Initiates a text search. 
.PP
Definition at line 2670 of file khtml_part.cpp.
.SS "bool KHTMLPart::findTextNext (const \fBQString\fP & str, bool forward, bool caseSensitive, bool isRegExp)"
.PP
Finds the next occurrence of the string or expression. 
.PP
If isRegExp is true then str is converted to a \fBQRegExp\fP, and caseSensitive is ignored. 
.PP
\fBDeprecated\fP
.RS 4
, use findText( str, options, parent, findDialog ) 
.RE
.PP

.PP
Definition at line 2747 of file khtml_part.cpp.
.PP
References DOM::DOMString::implementation(), QRegExp::matchedLength(), QRegExp::search(), and QRegExp::setCaseSensitive().
.SS "bool KHTMLPart::findTextNext ()"
.PP
Finds the next occurence of a string set by \fBfindText()\fP. 
.PP
\fBReturns:\fP
.RS 4
true if a new match was found. 
.RE
.PP
\fBSince:\fP
.RS 4
3.3 
.RE
.PP

.PP
Definition at line 2934 of file khtml_part.cpp.
.PP
References QString::append(), KShortcut::clear(), endl(), QString::find(), findText(), hasSelection(), QString::isEmpty(), kdDebug(), QString::length(), QString::replace(), QString::truncate(), KHTMLView::updateFindAheadTimeout(), and view().
.SS "void KHTMLPart::setZoomFactor (int percent)"
.PP
Sets the Zoom factor. 
.PP
The value is given in percent, larger values mean a generally larger font and larger page contents. It is not guaranteed that all parts of the page are scaled with the same factor though.
.PP
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. 
.PP
Definition at line 5506 of file khtml_part.cpp.
.PP
References QApplication::restoreOverrideCursor(), and QApplication::setOverrideCursor().
.PP
Referenced by restoreState().
.SS "int KHTMLPart::zoomFactor () const"
.PP
Returns the current zoom factor. 
.PP
Definition at line 5442 of file khtml_part.cpp.
.PP
Referenced by khtml::CSSStyleSelector::CSSStyleSelector(), KHTMLView::print(), and restoreState().
.SS "\fBQString\fP KHTMLPart::selectedText () const\fC [virtual]\fP"
.PP
Returns the text the user has marked. 
.PP
Definition at line 3276 of file khtml_part.cpp.
.PP
References DOM::Node::elementId(), DOM::Node::firstChild(), DOM::Node::handle(), QString::isEmpty(), KShortcut::isNull(), DOM::Node::isNull(), QString::left(), QString::length(), QString::mid(), DOM::Node::nextSibling(), DOM::Node::nodeType(), and DOM::Node::parentNode().
.PP
Referenced by khtmlMouseReleaseEvent().
.SS "\fBQString\fP KHTMLPart::selectedTextAsHTML () const"
.PP
Return the text the user has marked. 
.PP
This is guaranteed to be valid xml, and to contain the <html> and <body> tags.
.PP
FIXME probably should make virtual for 4.0 ?
.PP
\fBSince:\fP
.RS 4
3.4 
.RE
.PP

.PP
Definition at line 3259 of file khtml_part.cpp.
.PP
References endl(), hasSelection(), kdDebug(), and selection().
.SS "DOM::Range KHTMLPart::selection () const"
.PP
Returns the selected part of the HTML. 
.PP
Definition at line 3427 of file khtml_part.cpp.
.PP
References DOM::Document::createRange(), document(), endl(), DOM::Node::handle(), and kdDebug().
.PP
Referenced by selectedTextAsHTML().
.SS "void KHTMLPart::selection (\fBDOM::Node\fP & startNode, long & startOffset, \fBDOM::Node\fP & endNode, long & endOffset) const"
.PP
Returns the selected part of the HTML by returning the starting and end position. 
.PP
If there is no selection, both nodes and offsets are equal. 
.PP
\fBParameters:\fP
.RS 4
\fIstartNode\fP returns node selection starts in 
.br
\fIstartOffset\fP returns offset within starting node 
.br
\fIendNode\fP returns node selection ends in 
.br
\fIendOffset\fP returns offset within end node. 
.RE
.PP
\fBSince:\fP
.RS 4
3.2 
.RE
.PP

.PP
Definition at line 3481 of file khtml_part.cpp.
.SS "void KHTMLPart::setSelection (const DOM::Range &)"
.PP
Sets the current selection. 
.PP
Definition at line 3489 of file khtml_part.cpp.
.SS "bool KHTMLPart::hasSelection () const"
.PP
Has the user selected anything? 
.PP
Call \fBselectedText()\fP to retrieve the selected text.
.PP
\fBReturns:\fP
.RS 4
\fCtrue\fP if there is text selected. 
.RE
.PP

.PP
Definition at line 3417 of file khtml_part.cpp.
.PP
Referenced by findText(), findTextNext(), and selectedTextAsHTML().
.SS "void KHTMLPart::selectAll ()"
.PP
Marks all text in the document as selected. 
.PP
Definition at line 6479 of file khtml_part.cpp.
.SS "void KHTMLPart::show ()"
.PP
Convenience method to show the document's view. 
.PP
Equivalent to \fBwidget()\fP->\fBshow()\fP or \fBview()\fP->\fBshow()\fP . 
.PP
Definition at line 5410 of file khtml_part.cpp.
.PP
Referenced by KHTMLView::KHTMLView().
.SS "void KHTMLPart::hide ()"
.PP
Convenience method to hide the document's view. 
.PP
Equivalent to \fBwidget()\fP->\fBhide()\fP or \fBview()\fP->\fBhide()\fP. 
.PP
Definition at line 5416 of file khtml_part.cpp.
.SS "\fBKParts::PartManager\fP * KHTMLPart::partManager ()"
.PP
Returns a reference to the partmanager instance which manages html frame objects. 
.PP
Definition at line 4484 of file khtml_part.cpp.
.PP
References QObject::connect(), and KParts::PartManager::setAllowNestedParts().
.PP
Referenced by currentFrame().
.SS "void KHTMLPart::saveState (\fBQDataStream\fP & stream)\fC [virtual]\fP"
.PP
Saves the KHTMLPart's complete state (including child frame objects) to the provided \fBQDataStream\fP. 
.PP
This is called from the \fBsaveState()\fP method of the \fBbrowserExtension()\fP. 
.PP
Definition at line 5138 of file khtml_part.cpp.
.PP
References endl(), kdDebug(), QObject::name(), and KURL::url().
.SS "void KHTMLPart::restoreState (\fBQDataStream\fP & stream)\fC [virtual]\fP"
.PP
Restores the KHTMLPart's previously saved state (including child frame objects) from the provided \fBQDataStream\fP. 
.PP
\fBSee also:\fP
.RS 4
\fBsaveState()\fP
.RE
.PP
This is called from the \fBrestoreState()\fP method of the \fBbrowserExtension()\fP . 
.PP
Definition at line 5224 of file khtml_part.cpp.
.PP
References QValueList::append(), QValueList::begin(), closeURL(), QValueList::end(), frameNames(), openURL(), setZoomFactor(), and zoomFactor().
.SS "\fBDOM::Node\fP KHTMLPart::nodeUnderMouse () const"
.PP
Returns the \fCNode\fP currently under the mouse. 
.PP
The returned node may be a shared node (e. g. an <area> node if the mouse is hovering over an image map). 
.PP
Definition at line 5422 of file khtml_part.cpp.
.SS "\fBDOM::Node\fP KHTMLPart::nonSharedNodeUnderMouse () const"
.PP
Returns the \fCNode\fP currently under the mouse that is not shared. 
.PP
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). 
.PP
\fBSince:\fP
.RS 4
3.3 
.RE
.PP

.PP
Definition at line 5427 of file khtml_part.cpp.
.SS "\fBKHTMLPart\fP * KHTMLPart::parentPart ()"
.PP
Returns a pointer to the parent KHTMLPart if the part is a frame in an HTML frameset. 
.PP
Returns 0L otherwise. 
.PP
Definition at line 5101 of file khtml_part.cpp.
.PP
References QObject::parent().
.PP
Referenced by begin(), findFrameParent(), khtmlMouseMoveEvent(), khtmlMousePressEvent(), khtmlMouseReleaseEvent(), openURL(), setSuppressedPopupIndicator(), toplevelURL(), and ~KHTMLPart().
.SS "\fBQStringList\fP KHTMLPart::frameNames () const"
.PP
Returns a list of names of all frame (including iframe) objects of the current document. 
.PP
Note that this method is not working recursively for sub-frames. 
.PP
Definition at line 5666 of file khtml_part.cpp.
.PP
Referenced by restoreState().
.SS "\fBKHTMLPart\fP * KHTMLPart::findFrame (const \fBQString\fP & f)"
.PP
Finds a frame by name. 
.PP
Returns 0L if frame can't be found. 
.PP
Definition at line 5037 of file khtml_part.cpp.
.PP
References findFrameParent(), and QObject::inherits().
.SS "\fBKHTMLPart\fP * KHTMLPart::findFrameParent (\fBKParts::ReadOnlyPart\fP * callingPart, const \fBQString\fP & f, khtml::ChildFrame ** childFrame = \fC0\fP)"
.PP
Recursively finds the part containing the frame with name \fCf\fP and checks if it is accessible by \fCcallingPart\fP Returns 0L if no suitable frame can't be found. 
.PP
Returns parent part if a suitable frame was found and frame info in \fC*childFrame\fP 
.PP
\fBSince:\fP
.RS 4
3.3 
.RE
.PP

.PP
Definition at line 4996 of file khtml_part.cpp.
.PP
References endl(), QObject::inherits(), kdDebug(), QObject::name(), and parentPart().
.PP
Referenced by findFrame(), and findFramePart().
.SS "\fBKParts::ReadOnlyPart\fP * KHTMLPart::currentFrame () const"
.PP
Return the current frame (the one that has focus) Not necessarily a direct child of ours, framesets can be nested. 
.PP
Returns 'this' if this part isn't a frameset. 
.PP
Definition at line 5056 of file khtml_part.cpp.
.PP
References KParts::PartManager::activePart(), QObject::inherits(), and partManager().
.SS "bool KHTMLPart::frameExists (const \fBQString\fP & frameName)"
.PP
Returns whether a frame with the specified name is exists or not. 
.PP
In contrary to the findFrame method this one also returns true if the frame is defined but no displaying component has been found/loaded, yet. 
.PP
Definition at line 5071 of file khtml_part.cpp.
.SS "KJSProxy * KHTMLPart::framejScript (\fBKParts::ReadOnlyPart\fP * framePart)"
.PP
Returns child frame framePart its script interpreter. 
.PP
Definition at line 5083 of file khtml_part.cpp.
.PP
References begin(), end(), and jScript().
.SS "\fBKParts::ReadOnlyPart\fP * KHTMLPart::findFramePart (const \fBQString\fP & f)"
.PP
Finds a frame by name. 
.PP
Returns 0L if frame can't be found. 
.PP
Definition at line 5050 of file khtml_part.cpp.
.PP
References findFrameParent().
.SS "void KHTMLPart::setJSStatusBarText (const \fBQString\fP & text)"
.PP
Called by KJS. 
.PP
Sets the StatusBarText assigned via window.status 
.PP
Definition at line 5567 of file khtml_part.cpp.
.PP
References KParts::Part::setStatusBarText().
.SS "void KHTMLPart::setJSDefaultStatusBarText (const \fBQString\fP & text)"
.PP
Called by KJS. 
.PP
Sets the DefaultStatusBarText assigned via window.defaultStatus 
.PP
Definition at line 5572 of file khtml_part.cpp.
.PP
References KParts::Part::setStatusBarText().
.SS "\fBQString\fP KHTMLPart::jsStatusBarText () const"
.PP
Called by KJS. 
.PP
Returns the StatusBarText assigned via window.status 
.PP
Definition at line 5577 of file khtml_part.cpp.
.SS "\fBQString\fP KHTMLPart::jsDefaultStatusBarText () const"
.PP
Called by KJS. 
.PP
Returns the DefaultStatusBarText assigned via window.defaultStatus 
.PP
Definition at line 5582 of file khtml_part.cpp.
.SS "\fBQString\fP KHTMLPart::referrer () const"
.PP
Referrer used for links in this page. 
.PP
Definition at line 5587 of file khtml_part.cpp.
.SS "\fBQString\fP KHTMLPart::pageReferrer () const"
.PP
Referrer used to obtain this page. 
.PP
Definition at line 5592 of file khtml_part.cpp.
.PP
References KURL::isValid(), KURL::protocol(), KURL::setPass(), KURL::setRef(), KURL::setUser(), and KURL::url().
.SS "\fBQString\fP KHTMLPart::lastModified () const"
.PP
Last-modified date (in raw string format), if received in the [HTTP] headers. 
.PP
Definition at line 5613 of file khtml_part.cpp.
.PP
References KURL::isLocalFile(), KURL::path(), and QDateTime::toString().
.SS "void KHTMLPart::preloadStyleSheet (const \fBQString\fP & url, const \fBQString\fP & stylesheet)"
.PP
Loads a style sheet into the stylesheet cache. 
.PP
Definition at line 6703 of file khtml_part.cpp.
.SS "void KHTMLPart::preloadScript (const \fBQString\fP & url, const \fBQString\fP & script)"
.PP
Loads a script into the script cache. 
.PP
Definition at line 6708 of file khtml_part.cpp.
.SS "void KHTMLPart::setFormNotification (FormNotification fn)"
.PP
Determine if signal should be emitted before, instead or never when a submitForm() happens. 
.PP
\fBSince:\fP
.RS 4
3.2 ### KDE4 remove me 
.RE
.PP

.PP
Definition at line 7044 of file khtml_part.cpp.
.SS "KHTMLPart::FormNotification KHTMLPart::formNotification () const"
.PP
Determine if signal should be emitted before, instead or never when a submitForm() happens. 
.PP
### KDE4 remove me 
.PP
\fBSince:\fP
.RS 4
3.2 
.RE
.PP

.PP
Definition at line 7048 of file khtml_part.cpp.
.SS "\fBKURL\fP KHTMLPart::toplevelURL ()"
.PP
Returns the toplevel (origin) URL of this document, even if this part is a frame or an iframe. 
.PP
\fBReturns:\fP
.RS 4
the actual original url. 
.RE
.PP
\fBSince:\fP
.RS 4
3.2 
.RE
.PP

.PP
Definition at line 7052 of file khtml_part.cpp.
.PP
References parentPart(), and KParts::ReadOnlyPart::url().
.PP
Referenced by openURL().
.SS "bool KHTMLPart::isModified () const"
.PP
Checks whether the page contains unsubmitted form changes. 
.PP
\fBReturns:\fP
.RS 4
true if form changes exist 
.RE
.PP
\fBSince:\fP
.RS 4
3.3 
.RE
.PP

.PP
Definition at line 7064 of file khtml_part.cpp.
.SS "void KHTMLPart::setSuppressedPopupIndicator (bool enable)"
.PP
Shows or hides the suppressed popup indicator 
.PP
\fBSince:\fP
.RS 4
3.4. 
.RE
.PP

.PP
Definition at line 7087 of file khtml_part.cpp.
.PP
References QToolTip::add(), KXMLGUIClient::instance(), parentPart(), and QToolTip::remove().
.PP
Referenced by begin().
.SS "void KHTMLPart::onURL (const \fBQString\fP & url)\fC [signal]\fP"
.PP
Emitted if the cursor is moved over an URL. 
.PP
.SS "void KHTMLPart::popupMenu (const \fBQString\fP & url, const \fBQPoint\fP & point)\fC [signal]\fP"
.PP
Emitted when the user clicks the right mouse button on the document. 
.PP
Referenced by khtmlMouseMoveEvent(), and khtmlMousePressEvent().
.SS "void KHTMLPart::selectionChanged ()\fC [signal]\fP"
.PP
This signal is emitted when the selection changes. 
.PP
Referenced by findText(), and khtmlMouseReleaseEvent().
.SS "void KHTMLPart::nodeActivated (const \fBDOM::Node\fP &)\fC [signal]\fP"
.PP
This signal is emitted when an element retrieves the keyboard focus. 
.PP
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. 
.PP
Referenced by closeURL().
.SS "void KHTMLPart::caretPositionChanged (const \fBDOM::Node\fP & node, long offset)\fC [signal]\fP"
.PP
This signal is emitted whenever the caret position has been changed. 
.PP
The signal transmits the position the DOM::Range way, the node and the zero-based offset within this node. 
.PP
\fBParameters:\fP
.RS 4
\fInode\fP node which the caret is in. This can be null if the caret has been deactivated. 
.br
\fIoffset\fP offset within the node. If the node is null, the offset is meaningless. 
.RE
.PP
\fBSince:\fP
.RS 4
3.2 
.RE
.PP

.SS "void KHTMLPart::formSubmitNotification (const char * action, const \fBQString\fP & url, const \fBQByteArray\fP & formData, const \fBQString\fP & target, const \fBQString\fP & contentType, const \fBQString\fP & boundary)\fC [signal]\fP"
.PP
If form notification is on, this will be emitted either for a form submit or before the form submit according to the setting. 
.PP
\fBSince:\fP
.RS 4
3.2 ### KDE4 remove me 
.RE
.PP

.SS "\fBKURL\fP KHTMLPart::completeURL (const \fBQString\fP & url)\fC [protected]\fP"
.PP
returns a \fBKURL\fP object for the given url. 
.PP
Use when you know what you're doing. 
.PP
Definition at line 2311 of file khtml_part.cpp.
.PP
Referenced by khtmlMouseMoveEvent().
.SS "void KHTMLPart::htmlError (int errorCode, const \fBQString\fP & text, const \fBKURL\fP & reqUrl)\fC [protected]\fP"
.PP
presents a detailed error message to the user. 
.PP
\fCerrorCode\fP kio error code, eg KIO::ERR_SERVER_TIMEOUT. \fCtext\fP kio additional information text. \fCurl\fP the url that triggered the error. 
.PP
Definition at line 1676 of file khtml_part.cpp.
.PP
References QString::arg(), begin(), KParts::ReadOnlyPart::completed(), QStyleSheet::convertFromPlainText(), end(), endl(), KLocale::formatDateTime(), QString::fromLatin1(), QString::isNull(), QStringList::join(), kdDebug(), KGlobal::locale(), KIO::rawErrorDetail(), KParts::ReadOnlyPart::started(), and write().
.PP
Referenced by openURL(), and showError().
.SS "void KHTMLPart::khtmlMousePressEvent (khtml::MousePressEvent * event)\fC [protected, virtual]\fP"
.PP
Eventhandler of the khtml::MousePressEvent. 
.PP
Definition at line 5824 of file khtml_part.cpp.
.PP
References QMouseEvent::button(), QMouseEvent::globalPos(), DOM::Node::handle(), isEditable(), DOM::Node::isNull(), parentPart(), popupMenu(), QMouseEvent::pos(), and QMouseEvent::state().
.SS "void KHTMLPart::khtmlMouseDoubleClickEvent (khtml::MouseDoubleClickEvent *)\fC [protected, virtual]\fP"
.PP
Eventhandler for the khtml::MouseDoubleClickEvent. 
.PP
Definition at line 5904 of file khtml_part.cpp.
.PP
References QMouseEvent::button(), DOM::Node::handle(), DOM::Node::isNull(), and QMouseEvent::state().
.SS "void KHTMLPart::khtmlMouseMoveEvent (khtml::MouseMoveEvent * event)\fC [protected, virtual]\fP"
.PP
Eventhandler for the khtml::MouseMouseMoveEvent. 
.PP
Definition at line 6154 of file khtml_part.cpp.
.PP
References KMultipleDrag::addDragObject(), QString::arg(), completeURL(), QScrollView::contentsToViewport(), KGlobalSettings::dndEventDelay(), QDragObject::drag(), DOM::Node::elementId(), QMouseEvent::globalPos(), DOM::Node::handle(), isEditable(), DOM::Node::isNull(), QPixmap::isNull(), DOM::DOMString::length(), KURLDrag::metaData(), KMimeType::mimeType(), parentPart(), KMimeType::pixmapForURL(), popupMenu(), QMouseEvent::pos(), KURL::setPass(), QDragObject::setPixmap(), QMouseEvent::state(), DOM::DOMString::string(), view(), QMouseEvent::x(), and QMouseEvent::y().
.SS "void KHTMLPart::khtmlMouseReleaseEvent (khtml::MouseReleaseEvent * event)\fC [protected, virtual]\fP"
.PP
Eventhandler for the khtml::MouseMouseReleaseEvent. 
.PP
Definition at line 6293 of file khtml_part.cpp.
.PP
References QMouseEvent::button(), KParts::BrowserInterface::callMethod(), QObject::connect(), d, QObject::disconnect(), endl(), DOM::Node::firstChild(), KShortcut::isNull(), DOM::Node::isNull(), kdDebug(), DOM::Node::nextSibling(), DOM::Node::parentNode(), parentPart(), QString::replace(), selectedText(), selectionChanged(), and KParts::Part::setStatusBarText().
.SS "void KHTMLPart::khtmlDrawContentsEvent (khtml::DrawContentsEvent *)\fC [protected, virtual]\fP"
.PP
Eventhandler for the khtml::DrawContentsEvent. 
.PP
Definition at line 6407 of file khtml_part.cpp.
.SS "void KHTMLPart::guiActivateEvent (\fBKParts::GUIActivateEvent\fP * event)\fC [protected, virtual]\fP"
.PP
Internal reimplementation of \fBKParts::Part::guiActivateEvent\fP . 
.PP
Definition at line 6411 of file khtml_part.cpp.
.PP
References QPtrList::append(), and KXMLGUIClient::plugActionList().
.SS "bool KHTMLPart::openFile ()\fC [protected, virtual]\fP"
.PP
Internal empty reimplementation of \fBKParts::ReadOnlyPart::openFile\fP . 
.PP
Implements \fBKParts::ReadOnlyPart\fP.
.PP
Definition at line 1465 of file khtml_part.cpp.
.SS "\fBKParts::ReadOnlyPart\fP * KHTMLPart::createPart (\fBQWidget\fP * parentWidget, const char * widgetName, \fBQObject\fP * parent, const char * name, const \fBQString\fP & mimetype, \fBQString\fP & serviceName, \fBQStringList\fP & serviceTypes, const \fBQStringList\fP & params)\fC [protected, virtual]\fP"
.PP
This method is called when a new embedded object (include html frames) is to be created. 
.PP
Reimplement it if you want to add support for certain embeddable objects without registering them in the \fBKDE\fP 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' . 
.PP
Definition at line 4430 of file khtml_part.cpp.
.PP
References QString::append(), QValueList::begin(), KLibFactory::create(), QValueList::end(), endl(), KLibLoader::factory(), QObject::inherits(), QValueList::isEmpty(), kdWarning(), KTrader::query(), KLibLoader::self(), and KTrader::self().
.SS "bool KHTMLPart::doOpenStream (const \fBQString\fP & mimeType)\fC [protected, virtual]\fP"
.PP
Implements the streaming API of \fBKParts::ReadOnlyPart\fP. 
.PP
Definition at line 1965 of file khtml_part.cpp.
.PP
References begin(), KMimeType::mimeType(), and KParts::ReadOnlyPart::url().
.SS "bool KHTMLPart::doWriteStream (const \fBQByteArray\fP & data)\fC [protected, virtual]\fP"
.PP
Implements the streaming API of \fBKParts::ReadOnlyPart\fP. 
.PP
Definition at line 1976 of file khtml_part.cpp.
.PP
References write().
.SS "bool KHTMLPart::doCloseStream ()\fC [protected, virtual]\fP"
.PP
Implements the streaming API of \fBKParts::ReadOnlyPart\fP. 
.PP
Definition at line 1982 of file khtml_part.cpp.
.PP
References end().
.SS "void KHTMLPart::setActiveNode (const \fBDOM::Node\fP & node)\fC [slot]\fP"
.PP
Sets the focused node of the document to the specified node. 
.PP
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.
.PP
See activeNode
.PP
\fBParameters:\fP
.RS 4
\fInode\fP The node to focus 
.RE
.PP

.PP
Definition at line 6654 of file khtml_part.cpp.
.PP
References QRect::bottom(), QRect::left(), QRect::right(), and QRect::top().
.SS "void KHTMLPart::stopAnimations ()\fC [slot]\fP"
.PP
Stops all animated images on the current and child pages. 
.PP
Definition at line 1995 of file khtml_part.cpp.
.PP
References end().
.SS "\fBQVariant\fP KHTMLPart::executeScript (const \fBQString\fP & script)\fC [slot]\fP"
.PP
Execute the specified snippet of JavaScript code. 
.PP
Returns \fCtrue\fP if JavaScript was enabled, no error occurred and the code returned true itself or \fCfalse\fP otherwise. 
.PP
\fBDeprecated\fP
.RS 4
, use executeString( DOM::Node(), script) 
.RE
.PP

.PP
Definition at line 1156 of file khtml_part.cpp.
.PP
References executeScript().
.SS "void KHTMLPart::setCaretMode (bool enable)\fC [slot]\fP"
.PP
Enables/disables caret mode. 
.PP
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.
.PP
\fBParameters:\fP
.RS 4
\fIenable\fP \fCtrue\fP to enable, \fCfalse\fP to disable caret mode. 
.RE
.PP
\fBSince:\fP
.RS 4
3.2 
.RE
.PP

.PP
Definition at line 2578 of file khtml_part.cpp.
.PP
References KHTMLView::caretOff(), endl(), KHTMLView::ensureCaretVisible(), KHTMLView::initCaret(), isCaretMode(), isEditable(), kdDebug(), and view().
.SS "void KHTMLPart::setEditable (bool enable)\fC [slot]\fP"
.PP
Makes the document editable. 
.PP
Setting this property to \fCtrue\fP 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
.PP
\fBParameters:\fP
.RS 4
\fIenable\fP \fCtrue\fP to set document editable, \fCfalse\fP to set it read-only. 
.RE
.PP
\fBSince:\fP
.RS 4
3.2 (pending, do not use) 
.RE
.PP

.PP
Definition at line 2600 of file khtml_part.cpp.
.PP
References KHTMLView::caretOff(), KHTMLView::ensureCaretVisible(), KHTMLView::initCaret(), isCaretMode(), isEditable(), and view().
.SS "void KHTMLPart::setCaretVisible (bool show)\fC [slot]\fP"
.PP
Sets the visibility of the caret. 
.PP
This methods displays or hides the caret regardless of the current caret display policy (see setCaretDisplayNonFocused), and regardless of focus.
.PP
The caret will be shown/hidden only under at least one of the following conditions: 
.PD 0

.IP "\(bu" 2
the document is editable 
.IP "\(bu" 2
the document is in caret mode 
.IP "\(bu" 2
the document's currently focused element is editable
.PP
\fBParameters:\fP
.RS 4
\fIshow\fP \fCtrue\fP to make visible, \fCfalse\fP to hide. 
.RE
.PP
\fBSince:\fP
.RS 4
3.2 
.RE
.PP

.PP
Definition at line 2651 of file khtml_part.cpp.
.PP
References KHTMLView::caretOff(), KHTMLView::caretOn(), isCaretMode(), isEditable(), and view().

.SH "Author"
.PP 
Generated automatically by Doxygen for khtml Library from the source code.
