office-gobmx/accessibility/source/extended/AccessibleBrowseBox.cxx
Jens-Heiner Rechtien 58222b6e05 INTEGRATION: CWS a11ysep (1.1.2); FILE ADDED
2007/02/28 07:26:16 fs 1.1.2.4: #i10000#
2006/10/04 19:58:01 fs 1.1.2.3: MANUAL RESYNC m130->m185:
file was changed in MWS, but has been moved herein in CWS
2005/09/28 11:36:24 fs 1.1.2.2: manual resync (files have been moved herein from another location): licence change
2005/03/07 08:29:13 fs 1.1.2.1: #i44293# moved implementations herein from svtools module
2007-06-27 14:30:25 +00:00

423 lines
15 KiB
C++

/*************************************************************************
*
* OpenOffice.org - a multi-platform office productivity suite
*
* $RCSfile: AccessibleBrowseBox.cxx,v $
*
* $Revision: 1.2 $
*
* last change: $Author: hr $ $Date: 2007-06-27 15:30:25 $
*
* The Contents of this file are made available subject to
* the terms of GNU Lesser General Public License Version 2.1.
*
*
* GNU Lesser General Public License Version 2.1
* =============================================
* Copyright 2005 by Sun Microsystems, Inc.
* 901 San Antonio Road, Palo Alto, CA 94303, USA
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
* License version 2.1, as published by the Free Software Foundation.
*
* This library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this library; if not, write to the Free Software
* Foundation, Inc., 59 Temple Place, Suite 330, Boston,
* MA 02111-1307 USA
*
************************************************************************/
// MARKER(update_precomp.py): autogen include statement, do not remove
#include "precompiled_accessibility.hxx"
#ifndef ACCESSIBILITY_EXT_ACCESSIBLEBROWSEBOX_HXX
#include "accessibility/extended/AccessibleBrowseBox.hxx"
#endif
#ifndef ACCESSIBILITY_EXT_ACCESSIBLEBROWSEBOXTABLE_HXX
#include "accessibility/extended/AccessibleBrowseBoxTable.hxx"
#endif
#ifndef ACCESSIBILITY_EXT_ACCESSIBLEBROWSEBOXHEADERBAR_HXX
#include "accessibility/extended/AccessibleBrowseBoxHeaderBar.hxx"
#endif
#ifndef _SVTOOLS_ACCESSIBLETABLEPROVIDER_HXX
#include <svtools/accessibletableprovider.hxx>
#endif
#ifndef _COMPHELPER_TYPES_HXX_
#include <comphelper/types.hxx>
#endif
#ifndef _TOOLKIT_HELPER_VCLUNOHELPER_HXX_
#include <toolkit/helper/vclunohelper.hxx>
#endif
// ============================================================================
namespace accessibility
{
// ============================================================================
using ::rtl::OUString;
using namespace ::com::sun::star::uno;
using namespace ::com::sun::star;
using namespace ::com::sun::star::lang;
using namespace ::com::sun::star::accessibility;
using namespace ::svt;
// ============================================================================
class AccessibleBrowseBoxImpl
{
public:
/// the XAccessible which created the AccessibleBrowseBox
WeakReference< XAccessible > m_aCreator;
/** The data table child. */
Reference<
::com::sun::star::accessibility::XAccessible > mxTable;
AccessibleBrowseBoxTable* m_pTable;
/** The header bar for rows ("handle column"). */
Reference<
::com::sun::star::accessibility::XAccessible > mxRowHeaderBar;
AccessibleBrowseBoxHeaderBar* m_pRowHeaderBar;
/** The header bar for columns (first row of the table). */
Reference<
::com::sun::star::accessibility::XAccessible > mxColumnHeaderBar;
AccessibleBrowseBoxHeaderBar* m_pColumnHeaderBar;
};
// Ctor/Dtor/disposing --------------------------------------------------------
DBG_NAME( AccessibleBrowseBox )
AccessibleBrowseBox::AccessibleBrowseBox(
const Reference< XAccessible >& _rxParent, const Reference< XAccessible >& _rxCreator,
IAccessibleTableProvider& _rBrowseBox )
: AccessibleBrowseBoxBase( _rxParent, _rBrowseBox,NULL, BBTYPE_BROWSEBOX )
{
DBG_CTOR( AccessibleBrowseBox, NULL );
m_pImpl.reset( new AccessibleBrowseBoxImpl() );
m_pImpl->m_aCreator = _rxCreator;
m_xFocusWindow = VCLUnoHelper::GetInterface(mpBrowseBox->GetWindowInstance());
}
// -----------------------------------------------------------------------------
void AccessibleBrowseBox::setCreator( const Reference< XAccessible >& _rxCreator )
{
#if OSL_DEBUG_LEVEL > 0
Reference< XAccessible > xCreator = (Reference< XAccessible >)m_pImpl->m_aCreator;
DBG_ASSERT( !xCreator.is(), "accessibility/extended/AccessibleBrowseBox::setCreator: creator already set!" );
#endif
m_pImpl->m_aCreator = _rxCreator;
}
// -----------------------------------------------------------------------------
AccessibleBrowseBox::~AccessibleBrowseBox()
{
DBG_DTOR( AccessibleBrowseBox, NULL );
}
// -----------------------------------------------------------------------------
void SAL_CALL AccessibleBrowseBox::disposing()
{
::osl::MutexGuard aGuard( getOslMutex() );
m_pImpl->m_pTable = NULL;
m_pImpl->m_pColumnHeaderBar = NULL;
m_pImpl->m_pRowHeaderBar = NULL;
m_pImpl->m_aCreator = Reference< XAccessible >();
Reference< XAccessible > xTable = m_pImpl->mxTable;
Reference< XComponent > xComp( m_pImpl->mxTable, UNO_QUERY );
if ( xComp.is() )
{
xComp->dispose();
}
//! ::comphelper::disposeComponent(m_pImpl->mxTable);
::comphelper::disposeComponent(m_pImpl->mxRowHeaderBar);
::comphelper::disposeComponent(m_pImpl->mxColumnHeaderBar);
AccessibleBrowseBoxBase::disposing();
}
// -----------------------------------------------------------------------------
// XAccessibleContext ---------------------------------------------------------
sal_Int32 SAL_CALL AccessibleBrowseBox::getAccessibleChildCount()
throw ( uno::RuntimeException )
{
BBSolarGuard aSolarGuard;
::osl::MutexGuard aGuard( getOslMutex() );
ensureIsAlive();
return BBINDEX_FIRSTCONTROL + mpBrowseBox->GetAccessibleControlCount();
}
// -----------------------------------------------------------------------------
Reference< XAccessible > SAL_CALL
AccessibleBrowseBox::getAccessibleChild( sal_Int32 nChildIndex )
throw ( lang::IndexOutOfBoundsException, uno::RuntimeException )
{
BBSolarGuard aSolarGuard;
::osl::MutexGuard aGuard( getOslMutex() );
ensureIsAlive();
Reference< XAccessible > xRet;
if( nChildIndex >= 0 )
{
if( nChildIndex < BBINDEX_FIRSTCONTROL )
xRet = implGetFixedChild( nChildIndex );
else
{
// additional controls
nChildIndex -= BBINDEX_FIRSTCONTROL;
if( nChildIndex < mpBrowseBox->GetAccessibleControlCount() )
xRet = mpBrowseBox->CreateAccessibleControl( nChildIndex );
}
}
if( !xRet.is() )
throw lang::IndexOutOfBoundsException();
return xRet;
}
// -----------------------------------------------------------------------------
//sal_Int16 SAL_CALL AccessibleBrowseBox::getAccessibleRole()
// throw ( uno::RuntimeException )
//{
// ensureIsAlive();
// return AccessibleRole::PANEL;
//}
// -----------------------------------------------------------------------------
// XAccessibleComponent -------------------------------------------------------
Reference< XAccessible > SAL_CALL
AccessibleBrowseBox::getAccessibleAtPoint( const awt::Point& rPoint )
throw ( uno::RuntimeException )
{
BBSolarGuard aSolarGuard;
::osl::MutexGuard aGuard( getOslMutex() );
ensureIsAlive();
Reference< XAccessible > xChild;
sal_Int32 nIndex = 0;
if( mpBrowseBox->ConvertPointToControlIndex( nIndex, VCLPoint( rPoint ) ) )
xChild = mpBrowseBox->CreateAccessibleControl( nIndex );
else
{
// try whether point is in one of the fixed children
// (table, header bars, corner control)
Point aPoint( VCLPoint( rPoint ) );
for( nIndex = 0; (nIndex < BBINDEX_FIRSTCONTROL) && !xChild.is(); ++nIndex )
{
Reference< XAccessible > xCurrChild( implGetFixedChild( nIndex ) );
Reference< XAccessibleComponent >
xCurrChildComp( xCurrChild, uno::UNO_QUERY );
if( xCurrChildComp.is() &&
VCLRectangle( xCurrChildComp->getBounds() ).IsInside( aPoint ) )
xChild = xCurrChild;
}
}
return xChild;
}
// -----------------------------------------------------------------------------
void SAL_CALL AccessibleBrowseBox::grabFocus()
throw ( uno::RuntimeException )
{
BBSolarGuard aSolarGuard;
::osl::MutexGuard aGuard( getOslMutex() );
ensureIsAlive();
mpBrowseBox->GrabFocus();
}
// -----------------------------------------------------------------------------
Any SAL_CALL AccessibleBrowseBox::getAccessibleKeyBinding()
throw ( uno::RuntimeException )
{
ensureIsAlive();
return Any();
}
// -----------------------------------------------------------------------------
// XServiceInfo ---------------------------------------------------------------
OUString SAL_CALL AccessibleBrowseBox::getImplementationName()
throw ( uno::RuntimeException )
{
return OUString( RTL_CONSTASCII_USTRINGPARAM( "com.sun.star.comp.svtools.AccessibleBrowseBox" ) );
}
// -----------------------------------------------------------------------------
// internal virtual methods ---------------------------------------------------
Rectangle AccessibleBrowseBox::implGetBoundingBox()
{
Window* pParent = mpBrowseBox->GetAccessibleParentWindow();
DBG_ASSERT( pParent, "implGetBoundingBox - missing parent window" );
return mpBrowseBox->GetWindowExtentsRelative( pParent );
}
// -----------------------------------------------------------------------------
Rectangle AccessibleBrowseBox::implGetBoundingBoxOnScreen()
{
return mpBrowseBox->GetWindowExtentsRelative( NULL );
}
// -----------------------------------------------------------------------------
// internal helper methods ----------------------------------------------------
Reference< XAccessible > AccessibleBrowseBox::implGetTable()
{
if( !m_pImpl->mxTable.is() )
{
m_pImpl->m_pTable = createAccessibleTable();
m_pImpl->mxTable = m_pImpl->m_pTable;
}
return m_pImpl->mxTable;
}
// -----------------------------------------------------------------------------
Reference< XAccessible >
AccessibleBrowseBox::implGetHeaderBar( AccessibleBrowseBoxObjType eObjType )
{
Reference< XAccessible > xRet;
Reference< XAccessible >* pxMember = NULL;
if( eObjType == BBTYPE_ROWHEADERBAR )
pxMember = &m_pImpl->mxRowHeaderBar;
else if( eObjType == BBTYPE_COLUMNHEADERBAR )
pxMember = &m_pImpl->mxColumnHeaderBar;
if( pxMember )
{
if( !pxMember->is() )
{
AccessibleBrowseBoxHeaderBar* pHeaderBar = new AccessibleBrowseBoxHeaderBar(
(Reference< XAccessible >)m_pImpl->m_aCreator, *mpBrowseBox, eObjType );
if ( BBTYPE_COLUMNHEADERBAR == eObjType)
m_pImpl->m_pColumnHeaderBar = pHeaderBar;
else
m_pImpl->m_pRowHeaderBar = pHeaderBar;
*pxMember = pHeaderBar;
}
xRet = *pxMember;
}
return xRet;
}
// -----------------------------------------------------------------------------
Reference< XAccessible >
AccessibleBrowseBox::implGetFixedChild( sal_Int32 nChildIndex )
{
Reference< XAccessible > xRet;
switch( nChildIndex )
{
case BBINDEX_COLUMNHEADERBAR:
xRet = implGetHeaderBar( BBTYPE_COLUMNHEADERBAR );
break;
case BBINDEX_ROWHEADERBAR:
xRet = implGetHeaderBar( BBTYPE_ROWHEADERBAR );
break;
case BBINDEX_TABLE:
xRet = implGetTable();
break;
}
return xRet;
}
// -----------------------------------------------------------------------------
AccessibleBrowseBoxTable* AccessibleBrowseBox::createAccessibleTable()
{
Reference< XAccessible > xCreator = (Reference< XAccessible >)m_pImpl->m_aCreator;
DBG_ASSERT( xCreator.is(), "accessibility/extended/AccessibleBrowseBox::createAccessibleTable: my creator died - how this?" );
return new AccessibleBrowseBoxTable( xCreator, *mpBrowseBox );
}
// -----------------------------------------------------------------------------
void AccessibleBrowseBox::commitTableEvent(sal_Int16 _nEventId,const Any& _rNewValue,const Any& _rOldValue)
{
if ( m_pImpl->mxTable.is() )
{
m_pImpl->m_pTable->commitEvent(_nEventId,_rNewValue,_rOldValue);
}
}
// -----------------------------------------------------------------------------
void AccessibleBrowseBox::commitHeaderBarEvent( sal_Int16 _nEventId,
const Any& _rNewValue,
const Any& _rOldValue,sal_Bool _bColumnHeaderBar)
{
Reference< XAccessible > xHeaderBar = _bColumnHeaderBar ? m_pImpl->mxColumnHeaderBar : m_pImpl->mxRowHeaderBar;
AccessibleBrowseBoxHeaderBar* pHeaderBar = _bColumnHeaderBar ? m_pImpl->m_pColumnHeaderBar : m_pImpl->m_pRowHeaderBar;
if ( xHeaderBar.is() )
pHeaderBar->commitEvent(_nEventId,_rNewValue,_rOldValue);
}
// ============================================================================
// = AccessibleBrowseBoxAccess
// ============================================================================
DBG_NAME( AccessibleBrowseBoxAccess )
// -----------------------------------------------------------------------------
AccessibleBrowseBoxAccess::AccessibleBrowseBoxAccess( const Reference< XAccessible >& _rxParent, IAccessibleTableProvider& _rBrowseBox )
:m_xParent( _rxParent )
,m_rBrowseBox( _rBrowseBox )
,m_pContext( NULL )
{
DBG_CTOR( AccessibleBrowseBoxAccess, NULL );
}
// -----------------------------------------------------------------------------
AccessibleBrowseBoxAccess::~AccessibleBrowseBoxAccess()
{
DBG_DTOR( AccessibleBrowseBoxAccess, NULL );
}
// -----------------------------------------------------------------------------
void AccessibleBrowseBoxAccess::dispose()
{
::osl::MutexGuard aGuard( m_aMutex );
m_pContext = NULL;
::comphelper::disposeComponent( m_xContext );
}
// -----------------------------------------------------------------------------
Reference< XAccessibleContext > SAL_CALL AccessibleBrowseBoxAccess::getAccessibleContext() throw ( RuntimeException )
{
::osl::MutexGuard aGuard( m_aMutex );
DBG_ASSERT( ( m_pContext && m_xContext.is() ) || ( !m_pContext && !m_xContext.is() ),
"accessibility/extended/AccessibleBrowseBoxAccess::getAccessibleContext: inconsistency!" );
// if the context died meanwhile (we're no listener, so it won't tell us explicitily when this happens),
// then reset an re-create.
if ( m_pContext && !m_pContext->isAlive() )
m_xContext = m_pContext = NULL;
if ( !m_xContext.is() )
m_xContext = m_pContext = new AccessibleBrowseBox( m_xParent, this, m_rBrowseBox );
return m_xContext;
}
// -----------------------------------------------------------------------------
bool AccessibleBrowseBoxAccess::isContextAlive() const
{
return ( NULL != m_pContext ) && m_pContext->isAlive();
}
// ============================================================================
} // namespace accessibility