当前页面: 在线文档首页 > NetBeans API Javadoc 4.1.0

EditorCookie (NetBeans APIs) - NetBeans API Javadoc 4.1.0

Overview  Package   Class  Use  Tree  Deprecated  Index  Help
PREV CLASS   NEXT CLASS	FRAMES    NO FRAMES
SUMMARY: NESTED | FIELD | CONSTR | METHOD	DETAIL: FIELD | CONSTR | METHOD

---

org.openide.cookies
Interface EditorCookie

All Superinterfaces:

LineCookie, Node.Cookie

All Known Subinterfaces:

EditorCookie.Observable

---

public interface EditorCookie

extends LineCookie

Cookie defining standard operations with a text document and an editor that can display it. The cookie extends LineCookie because all implementations of editors should support access by lines.

The cookie provides interfaces for opening the file, closing the editor, background loading, saving of the document, and notification of modification.

Warning: it is not guaranteed that the document returned from this cookie will persist for the full lifetime of the cookie. That is, if the editor window is closed and then reopened, it is possible for the document to change. The EditorCookie.Observable allows listening to changes of the state of the document. You should do this if you are listening to changes in the document itself, as otherwise you would get no notifications from a reopened document.

---

Nested Class Summary
static interface	EditorCookie.Observable           The interface extends EditorCookie and allows observing changes in state of the text document.

 

Method Summary
boolean	close()           Closes all opened editors (if the user agrees) and flushes content of the document to file.
StyledDocument	getDocument()           Get the document (but do not block).
JEditorPane[]	getOpenedPanes()           Get a list of all editor panes opened on this object.
boolean	isModified()           Test whether the document is modified.
void	open()           Instructs an editor to be opened.
StyledDocument	openDocument()           Get the document (and wait).
Task	prepareDocument()           Should load the document into memory.
void	saveDocument()           Save the document.

 

Methods inherited from interface org.openide.cookies.LineCookie

getLineSet

 

Method Detail

open

public void open()

Instructs an editor to be opened. The operation can return immediately and the editor may be opened later. There can be more than one editor open, so one of them should be arbitrarily chosen and selected (typically given focus).

---

close

public boolean close()

Closes all opened editors (if the user agrees) and flushes content of the document to file.

Returns:

false if the operation has been cancelled

---

prepareDocument

public Task prepareDocument()

Should load the document into memory. This is done in a different thread. A task for the thread is returned so other components can test whether the loading is finished or not.

Note that this does not involve opening the actual Editor window. For that, use open().

Returns:

task for control over the loading process

---

openDocument

public StyledDocument openDocument()
                            throws IOException

Get the document (and wait). See the Editor API for details on how this document should behave.

If the document is not yet loaded the method blocks until it is.

Note that this does not involve opening the actual Editor window. For that, use open().

Returns:

the styled document for this cookie

Throws:

IOException - if the document could not be loaded

---

getDocument

public StyledDocument getDocument()

Get the document (but do not block).

Note that this does not involve opening the actual Editor window. For that, use open().

Returns:

the document, or null if it has not yet been loaded

---

saveDocument

public void saveDocument()
                  throws IOException

Save the document. This is done in the current thread.

Throws:

IOException - on I/O error

---

isModified

public boolean isModified()

Test whether the document is modified.

Returns:

true if the document is in memory and is modified; false otherwise

---

getOpenedPanes

public JEditorPane[] getOpenedPanes()

Get a list of all editor panes opened on this object. The first item in the array should represent the component that is currently selected or that was most recently selected. (Typically, multiple panes will only be open as a result of cloning the editor component.)

The resulting panes are useful for a range of tasks; most commonly, getting the current cursor position or text selection, including the Caret object.

This method may also be used to test whether an object is already open in an editor, without actually opening it.

Returns:

an array of panes, or null if no pane is open from this file. In no case is an empty array returned.

---

Overview  Package   Class  Use  Tree  Deprecated  Index  Help
PREV CLASS   NEXT CLASS	FRAMES    NO FRAMES
SUMMARY: NESTED | FIELD | CONSTR | METHOD	DETAIL: FIELD | CONSTR | METHOD

---

Built on May 4 2005.  |  Portions Copyright 1997-2005 Sun Microsystems, Inc. All rights reserved.