org.eclipse.swt.ole.win32

Class OleClientSite

java.lang.Object

org.eclipse.swt.widgets.Widget

org.eclipse.swt.widgets.Control

org.eclipse.swt.widgets.Scrollable

org.eclipse.swt.widgets.Composite

org.eclipse.swt.ole.win32.OleClientSite

All Implemented Interfaces:

Drawable

Direct Known Subclasses:

OleControlSite

public class OleClientSite
extends Composite

OleClientSite provides a site to manage an embedded OLE Document within a container.

The OleClientSite provides the following capabilities:

• creates the in-place editor for a blank document or opening an existing OLE Document
• lays the editor out
• provides a mechanism for activating and deactivating the Document
• provides a mechanism for saving changes made to the document

This object implements the OLE Interfaces IUnknown, IOleClientSite, IAdviseSink, IOleInPlaceSite

Note that although this class is a subclass of Composite, it does not make sense to add Control children to it, or set a layout on it.

Styles

BORDER

Events

Dispose, Move, Resize

See Also:

OLE and ActiveX snippets, SWT Examples: OLEExample, OleWebBrowser

Structure Diagram

Field Summary

Fields

Modifier and Type	Field and Description
protected GUID	appClsid
private int	aspect
private RECT	borderWidths
protected OleFrame	frame
private COMObject	iAdviseSink
private RECT	indent
private boolean	inDispose
private boolean	inInit
private boolean	inUpdate
(package private) COMObject	iOleClientSite
private COMObject	iOleDocumentSite
private COMObject	iOleInPlaceSite
(package private) boolean	isActivated
private boolean	isStatic
private COMObject	iUnknown
private Listener	listener
private GUID	objClsid
protected IOleDocumentView	objDocumentView
protected IOleCommandTarget	objIOleCommandTarget
protected IOleInPlaceObject	objIOleInPlaceObject
protected IOleObject	objIOleObject
protected IUnknown	objIUnknown
protected IViewObject2	objIViewObject2
private int	refCount
(package private) int	state
(package private) static int	STATE_ACTIVE
(package private) static int	STATE_INPLACEACTIVE
(package private) static int	STATE_NONE
(package private) static int	STATE_RUNNING
(package private) static int	STATE_UIACTIVE
protected IStorage	tempStorage
private int	type
private static java.lang.String	WORDPROGID

Fields inherited from class org.eclipse.swt.widgets.Control

handle

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	OleClientSite(Composite parent, int style)
	OleClientSite(Composite parent, int style, java.io.File file) Create an OleClientSite child widget using the OLE Document type associated with the specified file.
	OleClientSite(Composite parent, int style, java.lang.String progId) Create an OleClientSite child widget to edit a blank document using the specified OLE Document application.
	OleClientSite(Composite parent, int style, java.lang.String progId, java.io.File file) Create an OleClientSite child widget to edit the specified file using the specified OLE Document application.

Method Summary

Methods

Modifier and Type	Method and Description
(package private) int	ActivateMe(int pViewToActivate)
protected void	addObjectReferences()
protected int	AddRef()
private int	CanInPlaceActivate()
private int	ContextSensitiveHelp(int fEnterMode)
protected void	createCOMInterfaces()
protected IStorage	createTempStorage()
void	deactivateInPlaceClient() Deactivates an active in-place object and discards the object's undo state.
private void	deleteTempStorage()
protected void	disposeCOMInterfaces()
int	doVerb(int verb) Requests that the OLE Document or ActiveX Control perform an action; actions are almost always changes to the activation state.
int	exec(int cmdID, int options, Variant in, Variant out) Asks the OLE Document or ActiveX Control to execute a command from a standard list of commands.
(package private) IDispatch	getAutomationObject()
protected GUID	getClassID(java.lang.String clientName)
private int	GetContainer(int ppContainer)
private SIZE	getExtent()
Rectangle	getIndent() Returns the indent value that would be used to compute the clipping area of the active X object.
(package private) java.lang.String	getProgID(GUID clsid)
java.lang.String	getProgramID() Returns the program ID of the OLE Document or ActiveX Control.
(package private) RECT	getRect()
protected int	GetWindow(int phwnd)
private int	GetWindowContext(int ppFrame, int ppDoc, int lprcPosRect, int lprcClipRect, int lpFrameInfo)
boolean	isDirty() Returns whether ole document is dirty by checking whether the content of the file representing the document is dirty.
boolean	isFocusControl() Returns true if the receiver has the user-interface focus, and false otherwise.
(package private) boolean	isICAClient()
private boolean	isOffice2007(boolean program)
(package private) void	OleCreate(GUID appClsid, GUID fileClsid, char[] fileName, java.io.File file)
private int	OnClose()
private int	OnDataChange(int pFormatetc, int pStgmed)
private void	onDispose(Event e)
(package private) void	onFocusIn(Event e)
(package private) void	onFocusOut(Event e)
private int	OnInPlaceActivate()
private int	OnInPlaceDeactivate()
private void	onPaint(Event e)
private int	OnPosRectChange(int lprcPosRect)
private void	onResize(Event e)
private void	OnSave()
private int	OnShowWindow(int fShow)
private void	onTraverse(Event event)
private int	OnUIActivate()
(package private) int	OnUIDeactivate(int fUndoable)
private int	OnViewChange(int dwAspect, int lindex)
protected int	QueryInterface(int riid, int ppvObject)
int	queryStatus(int cmd) Returns the status of the specified command.
protected int	Release()
protected void	releaseObjectInterfaces()
boolean	save(java.io.File file, boolean includeOleInfo) Saves the document to the specified file and includes OLE specific information if specified.
private boolean	saveFromContents(int address, java.io.File file)
private boolean	saveFromOle10Native(int address, java.io.File file)
private int	SaveObject()
private boolean	saveOffice2007(java.io.File file)
private boolean	saveToStorageFile(java.io.File file) Saves the document to the specified file and includes OLE specific information.
private boolean	saveToTraditionalFile(java.io.File file) Saves the document to the specified file.
private int	Scroll_64(int scrollExtent)
private int	Scroll(int scrollExtent_cx, int scrollExtent_cy)
(package private) void	setBorderSpace(RECT newBorderwidth)
(package private) void	setBounds()
private void	setExtent(int width, int height)
void	setIndent(Rectangle newIndent) The indent value is no longer being used by the client site.
private void	setObjectRects()
private int	ShowObject()
void	showProperties(java.lang.String title) Displays a dialog with the property information for this OLE Object.
private boolean	updateStorage()
private SIZE	xFormHimetricToPixels(SIZE aSize)
private SIZE	xFormPixelsToHimetric(SIZE aSize)

Methods inherited from class org.eclipse.swt.widgets.Composite

changed, checkSubclass, computeSize, drawBackground, getBackgroundMode, getChildren, getLayout, getLayoutDeferred, getTabList, isLayoutDeferred, layout, layout, layout, layout, layout, setBackgroundMode, setFocus, setLayout, setLayoutDeferred, setTabList

Methods inherited from class org.eclipse.swt.widgets.Scrollable

computeTrim, getClientArea, getHorizontalBar, getScrollbarsMode, getVerticalBar

Methods inherited from class org.eclipse.swt.widgets.Control

addControlListener, addDragDetectListener, addFocusListener, addGestureListener, addHelpListener, addKeyListener, addMenuDetectListener, addMouseListener, addMouseMoveListener, addMouseTrackListener, addMouseWheelListener, addPaintListener, addTouchListener, addTraverseListener, computeSize, dragDetect, dragDetect, forceFocus, getAccessible, getBackground, getBackgroundImage, getBorderWidth, getBounds, getCursor, getDragDetect, getEnabled, getFont, getForeground, getLayoutData, getLocation, getMenu, getMonitor, getOrientation, getParent, getRegion, getShell, getSize, getToolTipText, getTouchEnabled, getVisible, internal_dispose_GC, internal_new_GC, isEnabled, isReparentable, isVisible, moveAbove, moveBelow, pack, pack, print, redraw, redraw, removeControlListener, removeDragDetectListener, removeFocusListener, removeGestureListener, removeHelpListener, removeKeyListener, removeMenuDetectListener, removeMouseListener, removeMouseMoveListener, removeMouseTrackListener, removeMouseWheelListener, removePaintListener, removeTouchListener, removeTraverseListener, setBackground, setBackgroundImage, setBounds, setBounds, setCapture, setCursor, setDragDetect, setEnabled, setFont, setForeground, setLayoutData, setLocation, setLocation, setMenu, setOrientation, setParent, setRedraw, setRegion, setSize, setSize, setToolTipText, setTouchEnabled, setVisible, toControl, toControl, toDisplay, toDisplay, traverse, traverse, traverse, update

Methods inherited from class org.eclipse.swt.widgets.Widget

addDisposeListener, addListener, checkWidget, dispose, getData, getData, getDisplay, getListeners, getStyle, isDisposed, isListening, notifyListeners, removeDisposeListener, removeListener, removeListener, reskin, setData, setData, toString

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

iUnknown

private COMObject iUnknown

iOleClientSite

COMObject iOleClientSite

iAdviseSink

private COMObject iAdviseSink

iOleInPlaceSite

private COMObject iOleInPlaceSite

iOleDocumentSite

private COMObject iOleDocumentSite

appClsid

protected GUID appClsid

objClsid

private GUID objClsid

refCount

private int refCount

frame

protected OleFrame frame

objIUnknown

protected IUnknown objIUnknown

objIOleObject

protected IOleObject objIOleObject

objIViewObject2

protected IViewObject2 objIViewObject2

objIOleInPlaceObject

protected IOleInPlaceObject objIOleInPlaceObject

objIOleCommandTarget

protected IOleCommandTarget objIOleCommandTarget

objDocumentView

protected IOleDocumentView objDocumentView

tempStorage

protected IStorage tempStorage

aspect

private int aspect

type

private int type

isStatic

private boolean isStatic

isActivated

boolean isActivated

borderWidths

private RECT borderWidths

indent

private RECT indent

inUpdate

private boolean inUpdate

inInit

private boolean inInit

inDispose

private boolean inDispose

WORDPROGID

private static final java.lang.String WORDPROGID

See Also:

Constant Field Values

listener

private Listener listener

STATE_NONE

static final int STATE_NONE

See Also:

Constant Field Values

STATE_RUNNING

static final int STATE_RUNNING

See Also:

Constant Field Values

STATE_INPLACEACTIVE

static final int STATE_INPLACEACTIVE

See Also:

Constant Field Values

STATE_UIACTIVE

static final int STATE_UIACTIVE

See Also:

Constant Field Values

STATE_ACTIVE

static final int STATE_ACTIVE

See Also:

Constant Field Values

state

int state

Constructor Detail

OleClientSite

protected OleClientSite(Composite parent,
             int style)

OleClientSite

public OleClientSite(Composite parent,
             int style,
             java.io.File file)

Create an OleClientSite child widget using the OLE Document type associated with the specified file. The OLE Document type is determined either through header information in the file or through a Registry entry for the file extension. Use style bits to select a particular look or set of properties.

Parameters:

parent - a composite widget; must be an OleFrame

style - the bitwise OR'ing of widget styles

file - the file that is to be opened in this OLE Document

Throws:

java.lang.IllegalArgumentException -

• ERROR_NULL_ARGUMENT when the parent is null
• ERROR_INVALID_ARGUMENT when the parent is not an OleFrame

SWTException -

• ERROR_THREAD_INVALID_ACCESS when called from the wrong thread
• ERROR_CANNOT_CREATE_OBJECT when failed to create OLE Object
• ERROR_CANNOT_OPEN_FILE when failed to open file
• ERROR_INTERFACE_NOT_FOUND when unable to create callbacks for OLE Interfaces
• ERROR_INVALID_CLASSID

OleClientSite

public OleClientSite(Composite parent,
             int style,
             java.lang.String progId)

Create an OleClientSite child widget to edit a blank document using the specified OLE Document application. Use style bits to select a particular look or set of properties.

Parameters:

parent - a composite widget; must be an OleFrame

style - the bitwise OR'ing of widget styles

progId - the unique program identifier of an OLE Document application; the value of the ProgID key or the value of the VersionIndependentProgID key specified in the registry for the desired OLE Document (for example, the VersionIndependentProgID for Word is Word.Document)

Throws:

java.lang.IllegalArgumentException -

• ERROR_NULL_ARGUMENT when the parent is null
• ERROR_INVALID_ARGUMENT when the parent is not an OleFrame

SWTException -

• ERROR_THREAD_INVALID_ACCESS when called from the wrong thread
• ERROR_INVALID_CLASSID when the progId does not map to a registered CLSID
• ERROR_CANNOT_CREATE_OBJECT when failed to create OLE Object

OleClientSite

public OleClientSite(Composite parent,
             int style,
             java.lang.String progId,
             java.io.File file)

Create an OleClientSite child widget to edit the specified file using the specified OLE Document application. Use style bits to select a particular look or set of properties.

IMPORTANT: This method is not part of the public API for OleClientSite. It is marked public only so that it can be shared within the packages provided by SWT. It is not available on all platforms, and should never be called from application code.

Parameters:

parent - a composite widget; must be an OleFrame

style - the bitwise OR'ing of widget styles

progId - the unique program identifier of am OLE Document application; the value of the ProgID key or the value of the VersionIndependentProgID key specified in the registry for the desired OLE Document (for example, the VersionIndependentProgID for Word is Word.Document)

file - the file that is to be opened in this OLE Document

Throws:

java.lang.IllegalArgumentException -

• ERROR_NULL_ARGUMENT when the parent is null
• ERROR_INVALID_ARGUMENT when the parent is not an OleFrame

SWTException -

• ERROR_THREAD_INVALID_ACCESS when called from the wrong thread
• ERROR_INVALID_CLASSID when the progId does not map to a registered CLSID
• ERROR_CANNOT_CREATE_OBJECT when failed to create OLE Object
• ERROR_CANNOT_OPEN_FILE when failed to open file

Method Detail

OleCreate

void OleCreate(GUID appClsid,
             GUID fileClsid,
             char[] fileName,
             java.io.File file)

addObjectReferences

protected void addObjectReferences()

AddRef

protected int AddRef()

CanInPlaceActivate

private int CanInPlaceActivate()

ContextSensitiveHelp

private int ContextSensitiveHelp(int fEnterMode)

createCOMInterfaces

protected void createCOMInterfaces()

createTempStorage

protected IStorage createTempStorage()

deactivateInPlaceClient

public void deactivateInPlaceClient()

Deactivates an active in-place object and discards the object's undo state.

deleteTempStorage

private void deleteTempStorage()

disposeCOMInterfaces

protected void disposeCOMInterfaces()

doVerb

public int doVerb(int verb)

Requests that the OLE Document or ActiveX Control perform an action; actions are almost always changes to the activation state.

Parameters:

verb - the operation that is requested. This is one of the OLE.OLEIVERB_ values

Returns:

an HRESULT value indicating the success of the operation request; OLE.S_OK indicates success

exec

public int exec(int cmdID,
       int options,
       Variant in,
       Variant out)

Asks the OLE Document or ActiveX Control to execute a command from a standard list of commands. The OLE Document or ActiveX Control must support the IOleCommandTarget interface. The OLE Document or ActiveX Control does not have to support all the commands in the standard list. To check if a command is supported, you can call queryStatus with the cmdID.

Parameters:

cmdID - the ID of a command; these are the OLE.OLECMDID_ values - a small set of common commands

options - the optional flags; these are the OLE.OLECMDEXECOPT_ values

in - the argument for the command

out - the return value of the command

Returns:

an HRESULT value; OLE.S_OK is returned if successful

getAutomationObject

IDispatch getAutomationObject()

getClassID

protected GUID getClassID(java.lang.String clientName)

GetContainer

private int GetContainer(int ppContainer)

getExtent

private SIZE getExtent()

getIndent

public Rectangle getIndent()

Returns the indent value that would be used to compute the clipping area of the active X object. NOTE: The indent value is no longer being used by the client site.

Returns:

the rectangle representing the indent

getProgramID

public java.lang.String getProgramID()

Returns the program ID of the OLE Document or ActiveX Control.

Returns:

the program ID of the OLE Document or ActiveX Control

getProgID

java.lang.String getProgID(GUID clsid)

ActivateMe

int ActivateMe(int pViewToActivate)

GetWindow

protected int GetWindow(int phwnd)

getRect

RECT getRect()

GetWindowContext

private int GetWindowContext(int ppFrame,
                   int ppDoc,
                   int lprcPosRect,
                   int lprcClipRect,
                   int lpFrameInfo)

isICAClient

boolean isICAClient()

isDirty

public boolean isDirty()

Returns whether ole document is dirty by checking whether the content of the file representing the document is dirty.

Returns:

true if the document has been modified, false otherwise.

Since:

3.1

isFocusControl

public boolean isFocusControl()

Description copied from class: Control

Returns true if the receiver has the user-interface focus, and false otherwise.

Overrides:

isFocusControl in class Control

Returns:

the receiver's focus state

isOffice2007

private boolean isOffice2007(boolean program)

OnClose

private int OnClose()

OnDataChange

private int OnDataChange(int pFormatetc,
               int pStgmed)

onDispose

private void onDispose(Event e)

onFocusIn

void onFocusIn(Event e)

onFocusOut

void onFocusOut(Event e)

OnInPlaceActivate

private int OnInPlaceActivate()

OnInPlaceDeactivate

private int OnInPlaceDeactivate()

OnPosRectChange

private int OnPosRectChange(int lprcPosRect)

onPaint

private void onPaint(Event e)

onResize

private void onResize(Event e)

OnSave

private void OnSave()

OnShowWindow

private int OnShowWindow(int fShow)

OnUIActivate

private int OnUIActivate()

OnUIDeactivate

int OnUIDeactivate(int fUndoable)

onTraverse

private void onTraverse(Event event)

OnViewChange

private int OnViewChange(int dwAspect,
               int lindex)

QueryInterface

protected int QueryInterface(int riid,
                 int ppvObject)

queryStatus

public int queryStatus(int cmd)

Returns the status of the specified command. The status is any bitwise OR'd combination of SWTOLE.OLECMDF_SUPPORTED, SWTOLE.OLECMDF_ENABLED, SWTOLE.OLECMDF_LATCHED, SWTOLE.OLECMDF_NINCHED. You can query the status of a command before invoking it with OleClientSite.exec. The OLE Document or ActiveX Control must support the IOleCommandTarget to make use of this method.

Parameters:

cmd - the ID of a command; these are the OLE.OLECMDID_ values - a small set of common commands

Returns:

the status of the specified command or 0 if unable to query the OLE Object; these are the OLE.OLECMDF_ values

Release

protected int Release()

releaseObjectInterfaces

protected void releaseObjectInterfaces()

save

public boolean save(java.io.File file,
           boolean includeOleInfo)

Saves the document to the specified file and includes OLE specific information if specified. This method must only be used for files that have an OLE Storage format. For example, a word file edited with Word.Document should be saved using this method because there is formating information that should be stored in the OLE specific Storage format.

Parameters:

file - the file to which the changes are to be saved

includeOleInfo - the flag to indicate whether OLE specific information should be saved.

Returns:

true if the save was successful

saveFromContents

private boolean saveFromContents(int address,
                       java.io.File file)

saveFromOle10Native

private boolean saveFromOle10Native(int address,
                          java.io.File file)

SaveObject

private int SaveObject()

saveOffice2007

private boolean saveOffice2007(java.io.File file)

saveToStorageFile

private boolean saveToStorageFile(java.io.File file)

Saves the document to the specified file and includes OLE specific information. This method must only be used for files that have an OLE Storage format. For example, a word file edited with Word.Document should be saved using this method because there is formating information that should be stored in the OLE specific Storage format.

Parameters:

file - the file to which the changes are to be saved

Returns:

true if the save was successful

saveToTraditionalFile

private boolean saveToTraditionalFile(java.io.File file)

Saves the document to the specified file. This method must be used for files that do not have an OLE Storage format. For example, a bitmap file edited with MSPaint should be saved using this method because bitmap is a standard format that does not include any OLE specific data.

Parameters:

file - the file to which the changes are to be saved

Returns:

true if the save was successful

Scroll_64

private int Scroll_64(int scrollExtent)

Scroll

private int Scroll(int scrollExtent_cx,
         int scrollExtent_cy)

setBorderSpace

void setBorderSpace(RECT newBorderwidth)

setBounds

void setBounds()

setExtent

private void setExtent(int width,
             int height)

setIndent

public void setIndent(Rectangle newIndent)

The indent value is no longer being used by the client site.

Parameters:

newIndent - the rectangle representing the indent amount

setObjectRects

private void setObjectRects()

ShowObject

private int ShowObject()

showProperties

public void showProperties(java.lang.String title)

Displays a dialog with the property information for this OLE Object. The OLE Document or ActiveX Control must support the ISpecifyPropertyPages interface.

Parameters:

title - the name that will appear in the titlebar of the dialog

updateStorage

private boolean updateStorage()

xFormHimetricToPixels

private SIZE xFormHimetricToPixels(SIZE aSize)

xFormPixelsToHimetric

private SIZE xFormPixelsToHimetric(SIZE aSize)