src/apps/cortex/addons/common/ControlAppLauncher.h

   1 /*
   2  * Copyright (c) 1999-2000, Eric Moon.
   3  * All rights reserved.
   4  *
   5  * Redistribution and use in source and binary forms, with or without
   6  * modification, are permitted provided that the following conditions
   7  * are met:
   8  *
   9  * 1. Redistributions of source code must retain the above copyright
  10  *    notice, this list of conditions, and the following disclaimer.
  11  *
  12  * 2. Redistributions in binary form must reproduce the above copyright
  13  *    notice, this list of conditions, and the following disclaimer in the
  14  *    documentation and/or other materials provided with the distribution.
  15  *
  16  * 3. The name of the author may not be used to endorse or promote products
  17  *    derived from this software without specific prior written permission.
  18  *
  19  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR "AS IS" AND ANY EXPRESS OR
  20  * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
  21  * OF TITLE, NON-INFRINGEMENT, MERCHANTABILITY AND FITNESS FOR A PARTICULAR
  22  * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY
  23  * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
  24  * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
  25  * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
  26  * AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR
  27  * TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
  28  * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  29  */
  30
  31
  32 // ControlAppLauncher.h
  33 // * PURPOSE
  34 //   A ControlAppLauncher manages a control-panel application
  35 //   for a given Media Kit node.  It takes responsibility for
  36 //   launching the application, maintaining a BMessenger to
  37 //   it for control purposes, and telling it to quit upon
  38 //   destruction.
  39 //
  40 // * HISTORY
  41 //   e.moon             17jun99         Begun.
  42
  43 #ifndef __ControlAppLauncher_H__
  44 #define __ControlAppLauncher_H__
  45
  46 #include <kernel/image.h>
  47 #include <MediaDefs.h>
  48 #include <Messenger.h>
  49
  50 class ControlAppLauncher {
  51 public:                                         // ctor/dtor
  52         virtual ~ControlAppLauncher(); //nyi
  53
  54         ControlAppLauncher(
  55                 media_node_id mediaNode,
  56                 bool launchNow=true); //nyi
  57
  58 public:                                         // accessors
  59         bool launched() const { return m_launched; }
  60         status_t error() const { return m_error; }
  61         const BMessenger& messenger() const { return m_messenger; }
  62
  63 public:                                         // operations
  64         status_t launch(); //nyi
  65
  66 private:                                                // guts
  67         void quit();
  68
  69         bool                                                    m_launched;
  70         status_t                                m_error;
  71         BMessenger                      m_messenger;
  72 };
  73
  74 #endif /*__ControlAppLauncher_H__*/