1*d1766043SAndrew Rist/************************************************************** 2cdf0e10cSrcweir * 3*d1766043SAndrew Rist * Licensed to the Apache Software Foundation (ASF) under one 4*d1766043SAndrew Rist * or more contributor license agreements. See the NOTICE file 5*d1766043SAndrew Rist * distributed with this work for additional information 6*d1766043SAndrew Rist * regarding copyright ownership. The ASF licenses this file 7*d1766043SAndrew Rist * to you under the Apache License, Version 2.0 (the 8*d1766043SAndrew Rist * "License"); you may not use this file except in compliance 9*d1766043SAndrew Rist * with the License. You may obtain a copy of the License at 10*d1766043SAndrew Rist * 11*d1766043SAndrew Rist * http://www.apache.org/licenses/LICENSE-2.0 12*d1766043SAndrew Rist * 13*d1766043SAndrew Rist * Unless required by applicable law or agreed to in writing, 14*d1766043SAndrew Rist * software distributed under the License is distributed on an 15*d1766043SAndrew Rist * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY 16*d1766043SAndrew Rist * KIND, either express or implied. See the License for the 17*d1766043SAndrew Rist * specific language governing permissions and limitations 18*d1766043SAndrew Rist * under the License. 19*d1766043SAndrew Rist * 20*d1766043SAndrew Rist *************************************************************/ 21*d1766043SAndrew Rist 22*d1766043SAndrew Rist 23cdf0e10cSrcweir 24cdf0e10cSrcweir#ifndef __com_sun_star_sdb_application_ApplicationController_idl__ 25cdf0e10cSrcweir#define __com_sun_star_sdb_application_ApplicationController_idl__ 26cdf0e10cSrcweir 27cdf0e10cSrcweir#include <com/sun/star/frame/Controller.idl> 28cdf0e10cSrcweir#include <com/sun/star/ui/XContextMenuInterception.idl> 29cdf0e10cSrcweir#include <com/sun/star/awt/XUserInputInterception.idl> 30cdf0e10cSrcweir#include <com/sun/star/view/XSelectionSupplier.idl> 31cdf0e10cSrcweir#include <com/sun/star/frame/XTitle.idl> 32cdf0e10cSrcweir#include <com/sun/star/frame/XTitleChangeBroadcaster.idl> 33cdf0e10cSrcweir#include <com/sun/star/sdb/application/XDatabaseDocumentUI.idl> 34cdf0e10cSrcweir 35cdf0e10cSrcweir//============================================================================= 36cdf0e10cSrcweir 37cdf0e10cSrcweirmodule com { module sun { module star { module sdb { module application { 38cdf0e10cSrcweir 39cdf0e10cSrcweir//============================================================================= 40cdf0e10cSrcweir 41cdf0e10cSrcweir/** is the default controller implementation for OpenOffice.org's database application. 42cdf0e10cSrcweir */ 43cdf0e10cSrcweirservice DefaultViewController 44cdf0e10cSrcweir{ 45cdf0e10cSrcweir /** defines basic controller functionality 46cdf0e10cSrcweir */ 47cdf0e10cSrcweir service ::com::sun::star::frame::Controller; 48cdf0e10cSrcweir 49cdf0e10cSrcweir /** allows intercepting context menu requests done by the user 50cdf0e10cSrcweir 51cdf0e10cSrcweir <p>The <member scope="::com::sun::star::ui">ContextMenuExecuteEvent::Selection</member> member 52cdf0e10cSrcweir of the event passed to an interceptor will <em>not</em> be the controller itself 53cdf0e10cSrcweir (though the controller also supports the <a href="#XSelectionSupplier"><code>XSelectionSupplier</code></a> 54cdf0e10cSrcweir interface), but a component which descrbes the current selection of the very window where the context 55cdf0e10cSrcweir menu was requested.</p> 56cdf0e10cSrcweir 57cdf0e10cSrcweir <p>In OpenOffice.org's database application, database objects such as tables, queries, forms, 58cdf0e10cSrcweir reports are displayed in a tree-like fashion. Currently, only context menu requests on this tree view 59cdf0e10cSrcweir can be intercepted using the <code>XContextMenuInterception</code> interface. Context menu requests 60cdf0e10cSrcweir in other places cannot be intercepted.</p> 61cdf0e10cSrcweir 62cdf0e10cSrcweir <p>For the aforementioned tree view, the selection supplied by the <code>ContextMenuEvent::Selection</code> 63cdf0e10cSrcweir component is an array of <type>NamedDatabaseObject</type> instances.</p> 64cdf0e10cSrcweir */ 65cdf0e10cSrcweir interface ::com::sun::star::ui::XContextMenuInterception; 66cdf0e10cSrcweir 67cdf0e10cSrcweir /** allows intercepting user input done by the user 68cdf0e10cSrcweir */ 69cdf0e10cSrcweir interface ::com::sun::star::awt::XUserInputInterception; 70cdf0e10cSrcweir 71cdf0e10cSrcweir /** <a name="XSelectionSupplier"></a> 72cdf0e10cSrcweir provides access to the current selection inside the application window, and allows to change it 73cdf0e10cSrcweir programmatically 74cdf0e10cSrcweir 75cdf0e10cSrcweir <p>The selection is an array of <type>NamedDatabaseObject</type> instances.</p> 76cdf0e10cSrcweir */ 77cdf0e10cSrcweir interface ::com::sun::star::view::XSelectionSupplier; 78cdf0e10cSrcweir 79cdf0e10cSrcweir /** allows to retrieve and set the title which of the component 80cdf0e10cSrcweir */ 81cdf0e10cSrcweir interface ::com::sun::star::frame::XTitle; 82cdf0e10cSrcweir 83cdf0e10cSrcweir /** allows being notified about changes in the component's title 84cdf0e10cSrcweir */ 85cdf0e10cSrcweir interface ::com::sun::star::frame::XTitleChangeBroadcaster; 86cdf0e10cSrcweir 87cdf0e10cSrcweir /** allows programmatic access to aspects of the application's user interface. 88cdf0e10cSrcweir */ 89cdf0e10cSrcweir interface XDatabaseDocumentUI; 90cdf0e10cSrcweir}; 91cdf0e10cSrcweir 92cdf0e10cSrcweir//============================================================================= 93cdf0e10cSrcweir 94cdf0e10cSrcweir}; }; }; }; }; 95cdf0e10cSrcweir 96cdf0e10cSrcweir//============================================================================= 97cdf0e10cSrcweir 98cdf0e10cSrcweir#endif 99