Class STA

lib/jacob-1.20_src/jacob-1.20/src/com/jacob/com/STA.java:27–101

A class that implements a Single Threaded Apartment. Users will subclass this and override OnInit() and OnQuit() where they will create and destroy a COM component that wants to run in an STA other than the main STA.

 * component that wants to run in an STA other than the main STA.
 */
public class STA extends Thread {
	/**
	 * referenced by STA.cpp
	 */
	public int threadID;

	/**
	 * constructor for STA
	 */
	public STA() {
		start(); // start the thread
	}

	/*
	 * (non-Javadoc)
	 * 
	 * @see java.lang.Thread#run()
	 */
	public void run() {
		// init COM
		ComThread.InitSTA();
		if (OnInit()) {
			// this call blocks in the win32 message loop
			// until quitMessagePump is called
			doMessagePump();
		}
		OnQuit();
		// uninit COM
		ComThread.Release();
	}

	/**
	 * Override this method to create and initialize any COM component that you
	 * want to run in this thread. If anything fails, return false to terminate
	 * the thread.
	 * 
	 * @return always returns true
	 */
	public boolean OnInit() {
		return true;
	}

	/**
	 * Override this method to destroy any resource before the thread exits and
	 * COM in uninitialized
	 */
	public void OnQuit() {
		// there is nothing to see here
	}

	/**
	 * calls quitMessagePump
	 */
	public void quit() {
		quitMessagePump();
	}

	/**