10.3 Symbol Changes

This article lists the symbols added to WebKit.framework in Mac OS X v10.3.

Classes

All of the classes with new symbols are listed alphabetically, with their new class, instance, and delegate methods described.

NSObject

Complete reference information is available in the NSObject reference.

Instance Methods

`downloadWindowForAuthenticationSheet:`	Returns the window to be used by the authentication sheet.
`webView:contextMenuItemsForElement: defaultMenuItems:`	Returns menu items to display in an element's contextual menu. (required)
`webView:createWebViewWithRequest:`	Creates a window containing a web view to load the specified request. (required)
`webView:decidePolicyForMIMEType: request:frame:decisionListener:`	Decides whether to display content with a given MIME type. (required)
`webView:decidePolicyForNavigationAction: request:frame:decisionListener:`	Routes a navigation action internally or to an external viewer. (required)
`webView:decidePolicyForNewWindowAction: request:newFrameName:decisionListener:`	Decides whether to allow a targeted navigation event, such as opening a link in a new window. (required)
`webView:didCancelClientRedirectForFrame:`	Invoked when a client redirect is cancelled. (required)
`webView:didChangeLocationWithinPageForFrame:`	Invoked when the scroll position within a frame changes. (required)
`webView:didCommitLoadForFrame:`	Invoked when content starts arriving for a page load. (required)
`webView:didFailLoadWithError:forFrame:`	Invoked when an error occurs loading a committed data source. (required)
`webView:didFailProvisionalLoadWithError:forFrame:`	Invoked if an error occurs when starting to load data for a page. (required)
`webView:didFinishLoadForFrame:`	Invoked when a page load completes. (required)
`webView:didReceiveIcon:forFrame:`	Invoked when a page icon changes. (required)
`webView: didReceiveServerRedirectForProvisionalLoadForFrame:`	Invoked when a provisional data source for a frame receives a server redirect. (required)
`webView:didReceiveTitle:forFrame:`	Invoked when the page title of a frame loads or changes. (required)
`webView:didStartProvisionalLoadForFrame:`	Invoked when a page load is in progress in a given frame. (required)
`webView:identifierForInitialRequest: fromDataSource:`	Returns an identifier object used to track the progress of loading a single resource. (required)
`webView:makeFirstResponder:`	Sets the first responder of a web view’s window to the specified view. (required)
`webView:mouseDidMoveOverElement:modifierFlags:`	Updates information about the element the user is mousing over. (required)
`webView:plugInFailedWithError:dataSource:`	Invoked when a plug-in fails to load. (required)
`webView:resource:didCancelAuthenticationChallenge: fromDataSource:`	Invoked when an authentication challenge for a resource was canceled. (required)
`webView:resource:didFailLoadingWithError: fromDataSource:`	Invoked when a resource failed to load. (required)
`webView:resource:didFinishLoadingFromDataSource:`	Invoked when all of the data for a given resource is loaded. (required)
`webView:resource: didReceiveAuthenticationChallenge: fromDataSource:`	Invoked when an authentication challenge has been received for a resource. (required)
`webView:resource:didReceiveContentLength: fromDataSource:`	Invoked when some of the data for a given resource has arrived. (required)
`webView:resource:didReceiveResponse: fromDataSource:`	Invoked after a resource has been loaded. (required)
`webView:resource:willSendRequest: redirectResponse:fromDataSource:`	Invoked before a request is initiated for a resource and returns a possibly modified request. (required)
`webView:runJavaScriptAlertPanelWithMessage:`	Displays a JavaScript alert panel. (required)
`webView:runJavaScriptConfirmPanelWithMessage:`	Displays a JavaScript confirm panel. (required)
`webView:runJavaScriptTextInputPanelWithPrompt: defaultText:`	Displays a JavaScript text input panel and returns the entered text. (required)
`webView: runOpenPanelForFileButtonWithResultListener:`	Displays an open panel for a file input control. (required)
`webView:setContentRect:`	Sets the window’s content view frame to the specified content rectangle. (required)
`webView:setFrame:`	Sets the frame rectangle of a web view’s window to the specified frame size. (required)
`webView:setResizable:`	Sets whether a web view’s window can be resized. (required)
`webView:setStatusBarVisible:`	Sets the visibility of the status bar in a web view’s window. (required)
`webView:setStatusText:`	Sets the status message displayed by a web view’s window, if any, to the specified text. (required)
`webView:setToolbarsVisible:`	Sets whether a web view's toolbars should be visible. (required)
`webView:unableToImplementPolicyWithError:frame:`	Handles or drops events that were rejected by a policy maker. (required)
`webView:willCloseFrame:`	Invoked when a frame will be closed. (required)
`webView:willPerformClientRedirectToURL: delay:fireDate:forFrame:`	Invoked when a frame receives a client redirect and before it is fired. (required)
`webViewAreToolbarsVisible:`	Returns a Boolean value indicating whether any toolbars are visible in a web view's window. (required)
`webViewClose:`	Closes a web view in a window. (required)
`webViewContentRect:`	Returns a web view window's content rectangle. (required)
`webViewFirstResponder:`	Returns the first responder of the web view’s window. (required)
`webViewFocus:`	Brings a web view’s window to the front and makes it the active window. (required)
`webViewFrame:`	Returns the frame rectangle of a web view’s window. (required)
`webViewIsResizable:`	Returns a Boolean value indicating whether a web view’s window can be resized. (required)
`webViewIsStatusBarVisible:`	Returns a Boolean value indicating whether the status bar in a web view's window is visible. (required)
`webViewShow:`	Displays a web view’s window and moves it to the front. (required)
`webViewStatusText:`	Returns the current status message from a web view's window. (required)
`webViewUnfocus:`	Relinquishes focus on a web view’s window. (required)

WebBackForwardList (New)

Complete reference information is available in the WebBackForwardList reference.

Instance Methods

`addItem:`	Inserts an item into the back-forward list, immediately after the current item.
`backItem`	Returns the item that precedes the current item in the back-forward list.
`backListCount`	Returns the number of items that precede the current item in the back-forward list.
`backListWithLimit:`	Returns the items that precede the current item in the back-forward list, up to the specified number of items.
`capacity`	Returns the maximum number of items that the back-forward list can contain.
`containsItem:`	Returns a Boolean value indicating whether the back-forward list contains the specified item.
`currentItem`	Returns the current item in the back-forward list.
`forwardItem`	Returns the item that follows the current item in the back-forward list.
`forwardListCount`	Returns the number of items that follow the current item in the back-forward list.
`forwardListWithLimit:`	Returns the items that follow the current item in the back-forward list, up to the specified number of items.
`goBack`	Moves backward one item in the back-forward list.
`goForward`	Moves forward one item in the back-forward list.
`goToItem:`	Makes the specified item in the back-forward list the current item.
`itemAtIndex:`	Returns the item at the specified index in the back-forward list.
`pageCacheSize`	Returns the maximum number of pages that the receiver can cache.
`setCapacity:`	Sets the maximum number of items that the back-forward list can contain.
`setPageCacheSize:`	Sets the maximum number of pages the receiver can cache.

WebDataSource (New)

Complete reference information is available in the WebDataSource reference.

Instance Methods

`data`	Returns the raw data that represents the data source’s content.
`initialRequest`	Returns a reference to the original request that was used to load the web content.
`initWithRequest:`	initializes a data source with a URL request.
`isLoading`	Returns whether the data source is loading its content.
`pageTitle`	Returns the title of the data source’s page.
`representation`	Returns the data source’s representation depending on its MIME type.
`request`	Returns the request that was used to create the data source.
`response`	Returns the associated WebResourceResponse object for this data source.
`textEncodingName`	Returns the text encoding for the data source’s web view, if set, or the text encoding of the response.
`webFrame`	Returns the web frame that represents this data source.

WebDownload (New)

Complete reference information is available in the WebDownload reference.

Delegate Methods

downloadWindowForAuthenticationSheet: Returns the window to be used by the authentication sheet.

WebFrame (New)

Complete reference information is available in the WebFrame reference.

Instance Methods

`childFrames`	Returns the frames of the web frame’s immediate children.
`dataSource`	Returns the committed data source.
`findFrameNamed:`	Returns a web frame that matches the given name.
`frameView`	Returns the web frame’s view object.
`initWithName:webFrameView:webView:`	Initializes the receiver with a frame name, web frame view, and controlling web view.
`loadData:MIMEType:textEncodingName:baseURL:`	Sets the main page contents, MIME type, content encoding, and base URL.
`loadHTMLString:baseURL:`	Sets the main page contents and base URL.
`loadRequest:`	Connects to a given URL by initiating an asynchronous client request.
`name`	Returns the web frame’s name.
`parentFrame`	Returns the web frame’s parent web frame.
`provisionalDataSource`	Returns the provisional data source.
`reload`	Reloads the initial request passed as an argument to loadRequest:.
`stopLoading`	Stops any pending loads on the receiver’s data source, and those of its children.
`webView`	Returns the view object that manages the web frame.

WebFrameView (New)

Complete reference information is available in the WebFrameView reference.

Instance Methods

`allowsScrolling`	Returns a Boolean value indicating whether users can scroll.
`documentView`	Returns the subview that displays the web content.
`setAllowsScrolling:`	Sets whether the frame view should allow users to scroll.
`webFrame`	Returns the web frame.

WebHistory (New)

Complete reference information is available in the WebHistory reference.

Class Methods

`optionalSharedHistory`	Returns a shared web history object, if one exists.
`setOptionalSharedHistory:`	Sets the web history object to share.

Instance Methods

`addItems:`	Inserts or updates the specified items in the web history.
`itemForURL:`	Returns the web history item that corresponds to the specified web location.
`loadFromURL:error:`	Loads the contents of the specified web history file.
`orderedItemsLastVisitedOnDay:`	Returns web history items that were last visited on the specified date.
`orderedLastVisitedDays`	Returns all calendar days represented in the web history.
`removeAllItems`	Removes all items from the web history.
`removeItems:`	Removes the specified items from the web history.
`saveToURL:error:`	Saves the web history to the specified file.

WebHistoryItem (New)

Complete reference information is available in the WebHistoryItem reference.

Instance Methods

`alternateTitle`	Returns an alternate title that may be used in place of the receiver’s page title.
`icon`	Returns the icon for the receiver’s page, or nil if none exists.
`initWithURLString:title:lastVisitedTimeInterval:`	Initializes the receiver with a URL,URLString, a title specified by title and the last time this item was visited specified by time title, and time last visited.
`lastVisitedTimeInterval`	Returns the last time and date the receiver’s page was visited.
`originalURLString`	Returns the string representation of the original URL for the receiver’s page.
`setAlternateTitle:`	Sets an alternate title for a page.
`title`	Returns the receiver’s original page title.
`URLString`	Returns the string representation of the URL for the receiver’s page.

WebPreferences (New)

Complete reference information is available in the WebPreferences reference.

Class Methods

standardPreferences Returns the standard set of preferences that may be used by all WebView objects.

Instance Methods

`allowsAnimatedImageLooping`	Returns whether or not the web view allows animated images to loop.
`allowsAnimatedImages`	Returns whether or not the web view allows animated images.
`arePlugInsEnabled`	Returns whether or not the web view allows plug-ins.
`autosaves`	Returns whether or not the receiver’s attributes are automatically stored in the user defaults database.
`cursiveFontFamily`	Returns the cursive font family for the web view.
`defaultFixedFontSize`	Returns the default fixed font size for the web view.
`defaultFontSize`	Returns the default font size for the web view.
`defaultTextEncodingName`	Returns the default text encoding for the web view.
`fantasyFontFamily`	Returns the fantasy font family for the web view.
`fixedFontFamily`	Returns the fixed font family for the web view.
`identifier`	Returns the receiver’s identifier.
`initWithIdentifier:`	Returns an initialized WebPreferences object, creating one if it does not exist.
`isJavaEnabled`	Returns whether or not Java is enabled for the web view.
`isJavaScriptEnabled`	Returns whether or not JavaScript is enabled for the web view.
`javaScriptCanOpenWindowsAutomatically`	Returns whether or not JavaScript can open windows automatically for the web view.
`loadsImagesAutomatically`	Returns whether images are loaded automatically for the web view.
`minimumFontSize`	Returns the minimum font size for the web view.
`minimumLogicalFontSize`	Returns the minimum logical font size for the web view.
`sansSerifFontFamily`	Returns the sans serif font family for the web view.
`serifFontFamily`	Returns the serif font family for the web view.
`setAllowsAnimatedImageLooping:`	Sets whether or not the receiver allows animated images to loop.
`setAllowsAnimatedImages:`	Sets whether or not the receiver allows animated images.
`setAutosaves:`	Sets whether or not the receiver’s attributes are stored in the user defaults database.
`setCursiveFontFamily:`	Sets the cursive font family of the web view.
`setDefaultFixedFontSize:`	Sets the default fixed font size of the web view.
`setDefaultFontSize:`	Sets the default font size of the web view.
`setDefaultTextEncodingName:`	Sets the default text encoding of the web view.
`setFantasyFontFamily:`	Sets the fantasy font family of the web view.
`setFixedFontFamily:`	Sets the fixed font family of the web view.
`setJavaEnabled:`	Sets whether or not the web view allows Java.
`setJavaScriptCanOpenWindowsAutomatically:`	Sets whether or not the web view allows JavaScript to open windows automatically.
`setJavaScriptEnabled:`	Sets whether or not the web view allows JavaScript.
`setLoadsImagesAutomatically:`	Sets whether or not the web view allows images to be loaded automatically.
`setMinimumFontSize:`	Sets the minimum font size of the web view.
`setMinimumLogicalFontSize:`	Sets the minimum logical font size of the web view.
`setPlugInsEnabled:`	Sets whether or not the web view allows plug-ins.
`setSansSerifFontFamily:`	Sets the sans serif font family of the web view.
`setSerifFontFamily:`	Sets the serif font family of the web view.
`setShouldPrintBackgrounds:`	Sets whether or not the web view should include backgrounds when printing.
`setStandardFontFamily:`	Sets the standard font family of the web view.
`setUserStyleSheetEnabled:`	Sets whether or not user style sheets are enabled in the web view.
`setUserStyleSheetLocation:`	Sets the location of the user style sheet.
`shouldPrintBackgrounds`	Returns whether the web view should include backgrounds when printing.
`standardFontFamily`	Returns the standard font family used by the web view.
`userStyleSheetEnabled`	Returns whether user style sheets are enabled in the web view.
`userStyleSheetLocation`	Returns the location of the user style sheet.

WebView (New)

Complete reference information is available in the WebView reference.

Class Methods

`canShowMIMEType:`	Returns whether the receiver can display content of a given MIME type.
`canShowMIMETypeAsHTML:`	Returns whether the receiver interprets a MIME type as HTML.
`registerViewClass:representationClass:forMIMEType:`	Specifies the view and representation objects to be used for specific MIME types.

Instance Methods

`applicationNameForUserAgent`	Returns the receiver’s application name that is used in the user-agent string.
`backForwardList`	Returns the receiver’s back-forward list.
`canGoBack`	Returns whether the previous location can be loaded.
`canGoForward`	Returns whether the next location can be loaded.
`canMakeTextLarger`	Returns whether the text can be made larger.
`canMakeTextSmaller`	Returns whether the text can be made smaller.
`customTextEncodingName`	Returns the custom text encoding name.
`customUserAgent`	Returns the receiver’s custom user-agent string.
`downloadDelegate`	Return the receiver’s download delegate.
`estimatedProgress`	Returns an estimate, as a percentage, of the amount of content that is currently loaded.
`frameLoadDelegate`	Return the receiver’s frame load delegate.
`goBack`	Loads the previous location in the back-forward list.
`goBack:`	An action method that loads the previous location in the back-forward list.
`goForward`	Loads the next location in the back-forward list.
`goForward:`	An action method that loads the next location in the back-forward list.
`goToBackForwardItem:`	Loads a specific location from the back-forward list and sets it as the current item.
`groupName`	Returns the receiver’s group name.
`hostWindow`	Returns the receiver’s host window.
`initWithFrame:frameName:groupName:`	Initializes the receiver with a frame rectangle, frame name, and group name.
`mainFrame`	Returns the main frame, the root of the web frame hierarchy for this page.
`makeTextLarger:`	Action method that increases the text size by one unit.
`makeTextSmaller:`	Action method that reduces the text size by one unit.
`policyDelegate`	Returns the receiver's policy delegate.
`preferences`	Returns the receiver’s preferences.
`preferencesIdentifier`	Returns the identifier of the receiver’s preferences.
`reload:`	An action method that reloads the current page.
`resourceLoadDelegate`	Returns the receiver’s resource load delegate.
`searchFor:direction:caseSensitive:wrap:`	Searches a document view for a string and highlights it if it is found.
`setApplicationNameForUserAgent:`	Sets the application name used in the user-agent string.
`setCustomTextEncodingName:`	Sets the custom text encoding name.
`setCustomUserAgent:`	Sets the receiver’s custom user-agent string.
`setDownloadDelegate:`	Sets the receiver's shared download delegate.
`setFrameLoadDelegate:`	Sets the receiver's frame load delegate.
`setGroupName:`	Sets the receiver's group name.
`setHostWindow:`	Sets the receiver's host window.
`setMaintainsBackForwardList:`	Sets whether to use a back-forward list.
`setPolicyDelegate:`	Sets the receiver's policy delegate.
`setPreferences:`	Sets the receiver’s preferences.
`setPreferencesIdentifier:`	Sets the receiver's preferences identifier, creating a preferences object if needed.
`setResourceLoadDelegate:`	Sets the receiver's resource load delegate.
`setTextSizeMultiplier:`	Change the font size multiplier for text displayed in web frame view objects managed by the receiver.
`setUIDelegate:`	Sets the receiver's user interface delegate.
`stopLoading:`	An action method that stops the loading of any web frame content managed by the receiver.
`stringByEvaluatingJavaScriptFromString:`	Returns the result of running a script.
`supportsTextEncoding`	Returns whether the document view supports different text encodings.
`takeStringURLFrom:`	Sets the receiver’s current location by obtaining a URL string from the sender.
`textSizeMultiplier`	Returns the font size multiplier for text displayed in web frame view objects managed by the receiver.
`UIDelegate`	Returns the receiver's user interface delegate.
`userAgentForURL:`	Returns the appropriate user-agent string for a given URL.

Protocols

All of the protocols with new symbols are listed alphabetically, with their new methods described.

WebDocumentRepresentation (New)

Complete reference information is available in the WebDocumentRepresentation reference.

Instance Methods

`canProvideDocumentSource`	Returns whether the receiver can provide content source. (required)
`documentSource`	Returns the receiver’s source as text. (required)
`finishedLoadingWithDataSource:`	Invoked when a data source finishes loading its content. (required)
`receivedData:withDataSource:`	Invoked when a data source has received some data. (required)
`receivedError:withDataSource:`	Invoked when a data source receives an error loading its content. (required)
`setDataSource:`	Sets the receiver’s data source. (required)
`title`	Returns the receiver’s document title. (required)

WebDocumentSearching (New)

Complete reference information is available in the WebDocumentSearching reference.

Instance Methods

searchFor:direction:caseSensitive:wrap: Searches for a string in a given direction from the current position. (required)

WebDocumentText (New)

Complete reference information is available in the WebDocumentText reference.

Instance Methods

`attributedString`	Returns the entire content of the web document as an attributed string. (required)
`deselectAll`	Deselects the currently selected text in the web document. (required)
`selectAll`	Selects all the text in the web document. (required)
`selectedAttributedString`	Returns the currently selected text in the web document as an attributed string. (required)
`selectedString`	Returns the currently selected text in the web document as a string. (required)
`string`	Returns the entire content of the web document as a string. (required)
`supportsTextEncoding`	Returns a Boolean value that indicates whether the web document supports text encoding. (required)

WebDocumentView (New)

Complete reference information is available in the WebDocumentView reference.

Instance Methods

`dataSourceUpdated:`	Invoked when additional data has been received. (required)
`layout`	Invoked when the receiver should change its layout immediately. (required)
`setDataSource:`	Invoked when the data source for this document has been changed. (required)
`setNeedsLayout:`	Sets whether or not the receiver should change its layout. (required)
`viewDidMoveToHostWindow`	Invoked when a web view's host window is set. (required)
`viewWillMoveToHostWindow:`	Invoked when a web view’s host window is about to change. (required)

WebOpenPanelResultListener (New)

Complete reference information is available in the WebOpenPanelResultListener reference.

Instance Methods

`cancel`	Invoked when a file open operation was cancelled. (required)
`chooseFilename:`	Displays a file open panel and returns the selected filename. (required)

WebPolicyDecisionListener (New)

Complete reference information is available in the WebPolicyDecisionListener reference.

Instance Methods

`download`	Tells the listener to download the resource instead of displaying it. (required)
`ignore`	Tells the listener to ignore the resource. (required)
`use`	Tells the listener to use the resource. (required)

C Symbols

All of the header files with new symbols are listed alphabetically, with their new symbols described.

CarbonUtils.h

Functions

All of the new functions in this header file are listed alphabetically, with links to documentation and abstracts, if available.

`WebConvertNSImageToCGImageRef`	Creates a Core Graphics image from a Cocoa NSImage.
`WebInitForCarbon`	Initializes the WebKit.

HIWebView.h

Functions

All of the new functions in this header file are listed alphabetically, with links to documentation and abstracts, if available.

`HIWebViewCreate`	Creates an HIView-based container for web content.
`HIWebViewGetWebView`	Obtains the Cocoa NSView associated with the web view.