/************************************************************** * * Licensed to the Apache Software Foundation (ASF) under one * or more contributor license agreements. See the NOTICE file * distributed with this work for additional information * regarding copyright ownership. The ASF licenses this file * to you under the Apache License, Version 2.0 (the * "License"); you may not use this file except in compliance * with the License. You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, * software distributed under the License is distributed on an * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY * KIND, either express or implied. See the License for the * specific language governing permissions and limitations * under the License. * *************************************************************/ // MARKER(update_precomp.py): autogen include statement, do not remove #include "precompiled_sfx2.hxx" #include #ifndef GCC #endif #include #include #include #include #include "statcach.hxx" #include //==================================================================== DBG_NAME(SfxControllerItem); //-------------------------------------------------------------------- #ifdef DBG_UTIL void SfxControllerItem::CheckConfigure_Impl( sal_uIntPtr nType ) { // echter Slot? (also kein Separator etc.) if ( !nId ) return; // ist die Id "uberhaupt in 'nType' konfigurierbar? const SfxSlot *pSlot = SFX_SLOTPOOL().GetSlot(nId); DBG_ASSERTWARNING( pSlot, "SfxControllerItem: binding not existing slot" ); if ( pSlot && !pSlot->IsMode(nType) ) { DBG_WARNING( "SfxControllerItem: slot without ...Config-flag" ); DbgOutf( "SfxControllerItem: Config-flag missing at SID %5d", pSlot->GetSlotId() ); } } #endif //-------------------------------------------------------------------- // returns the next registered SfxControllerItem with the same id SfxControllerItem* SfxControllerItem::GetItemLink() { DBG_MEMTEST(); DBG_CHKTHIS(SfxControllerItem, 0); return pNext == this ? 0 : pNext; } //-------------------------------------------------------------------- // returns sal_True if this binding is really bound to a function sal_Bool SfxControllerItem::IsBound() const { DBG_MEMTEST(); DBG_CHKTHIS(SfxControllerItem, 0); return pNext != this; } //-------------------------------------------------------------------- // returns the associated function-id or 0 if none // sal_uInt16 SfxControllerItem::GetId() const; //==================================================================== // registeres with the id at the bindings void SfxControllerItem::Bind( sal_uInt16 nNewId, SfxBindings *pBindinx ) { DBG_MEMTEST(); DBG_CHKTHIS(SfxControllerItem, 0); DBG_ASSERT(pBindings || pBindinx, "Keine Bindings"); if ( IsBound() ) { DBG_ASSERT(pBindings, "Keine Bindings"); pBindings->Release(*this); } nId = nNewId; pNext = 0; if (pBindinx) pBindings = pBindinx; pBindings->Register(*this); } void SfxControllerItem::BindInternal_Impl( sal_uInt16 nNewId, SfxBindings *pBindinx ) { DBG_MEMTEST(); DBG_CHKTHIS(SfxControllerItem, 0); DBG_ASSERT(pBindings || pBindinx, "Keine Bindings"); if ( IsBound() ) { DBG_ASSERT(pBindings, "Keine Bindings"); pBindings->Release(*this); } nId = nNewId; pNext = 0; if (pBindinx) pBindings = pBindinx; pBindings->RegisterInternal_Impl(*this); } //==================================================================== void SfxControllerItem::UnBind() /* [Beschreibung] "ost die Verbindung dieses SfxControllerItems mit der SfxBindings-Instanz, an der es zur Zeit gebunden ist. Ab diesem Zeitpunkt erh"alt es keine Statusbenachrichtigungen () mehr. [Querverweise] */ { DBG_MEMTEST(); DBG_CHKTHIS(SfxControllerItem, 0); DBG_ASSERT(pBindings, "Keine Bindings"); DBG_ASSERT( IsBound(), "unbindings unbound SfxControllerItem" ); pBindings->Release(*this); pNext = this; } //==================================================================== void SfxControllerItem::ReBind() /* [Beschreibung] Binded dieses SfxControllerItem wieder an die SfxBindings-Instanz, an der es zuletzt gebunden war. Ab diesem Zeitpunkt erh"alt es wieder Statusbenachrichtigungen (). [Querverweise] */ { DBG_MEMTEST(); DBG_CHKTHIS(SfxControllerItem, 0); DBG_ASSERT(pBindings, "Keine Bindings"); DBG_ASSERT( !IsBound(), "bindings rebound SfxControllerItem" ); pBindings->Register(*this); } //==================================================================== void SfxControllerItem::UpdateSlot() /* [Beschreibung] Holt den Status 'hart' neu. [Querverweise] */ { DBG_MEMTEST(); DBG_CHKTHIS(SfxControllerItem, 0); DBG_ASSERT(pBindings, "Keine Bindings"); pBindings->Update( GetId() ); } //-------------------------------------------------------------------- void SfxControllerItem::ClearCache() /* [Beschreibung] "oscht den Status-Cache f"ur dieses SfxControllerItem. D.h. beim n"achsten Status-Update wird das auf jeden Fall geschickt, auch wenn zuvor dasselbe geschickt wurde. Dies wird ben"otigt, wenn ein Controller umgeschaltet werden kann und sich diesen Status selbst merkt. [Beispiel] Der Kombi-Controller f"ur das Einstellen des Fl"achentyps und der konkreten Auspr"agung (Farbe blau oder Schraffur X) kann im Typ umgestellt werden, wird jedoch dann bei der n"achsten Selektion wieder benachrichtigt, auch wenn es dieselben Daten sind. [Querverweise] */ { DBG_MEMTEST(); DBG_CHKTHIS(SfxControllerItem, 0); DBG_ASSERT(pBindings, "Keine Bindings"); pBindings->ClearCache_Impl( GetId() ); } //-------------------------------------------------------------------- // replaces the successor in the list of bindings of the same id SfxControllerItem* SfxControllerItem::ChangeItemLink( SfxControllerItem* pNewLink ) { DBG_MEMTEST(); DBG_CHKTHIS(SfxControllerItem, 0); SfxControllerItem* pOldLink = pNext; pNext = pNewLink; return pOldLink == this ? 0 : pOldLink; } //-------------------------------------------------------------------- // changes the id of unbound functions (e.g. for sub-menu-ids) void SfxControllerItem::SetId( sal_uInt16 nItemId ) { DBG_MEMTEST(); DBG_CHKTHIS(SfxControllerItem, 0); DBG_ASSERT( !IsBound(), "changing id of bound binding" ); nId = nItemId; } //-------------------------------------------------------------------- // creates a atomic item for a controller without registration SfxControllerItem::SfxControllerItem(): nId(0), pNext(this), pBindings(0) { DBG_MEMTEST(); DBG_CTOR(SfxControllerItem, 0); } //-------------------------------------------------------------------- // creates a representation of the function nId and registeres it SfxControllerItem::SfxControllerItem( sal_uInt16 nID, SfxBindings &rBindings ): nId(nID), pNext(this), pBindings(&rBindings) { DBG_MEMTEST(); DBG_CTOR(SfxControllerItem, 0); Bind(nId, &rBindings); } //-------------------------------------------------------------------- // unregisteres the item in the bindings SfxControllerItem::~SfxControllerItem() { DBG_MEMTEST(); if ( IsBound() ) pBindings->Release(*this); DBG_DTOR(SfxControllerItem, 0); } //-------------------------------------------------------------------- void SfxControllerItem::StateChanged ( sal_uInt16 , // des ausl"osenden Slot SfxItemState , // von 'pState' const SfxPoolItem* // Slot-Status, ggf. 0 oder IsInvalidItem() ) /* [Beschreibung] Diese virtuelle Methode wird vom SFx gerufen, um s dar"uber zu benachrichtigen, da\s sich der Status des Slots 'nSID' ge"andert hat. Der neue Wert sowie der von diesem Wert ermittelte Status wird als 'pState' bzw. 'eState' mitgegeben. Der Status eines Slots kann sich "andern, wenn z.B. das MDI-Fenster gewechselt wird oder der Slot explizit mit invalidiert wurde. Achtung! Die Methode wird nicht gerufen, wenn der Slot ung"ultig wurde, danach jedoch wieder denselben Wert angenommen hat. Diese Basisklasse braucht nicht gerufen zu werden, weitere Zwischenstufen jedoch (z.B. ) sollten gerufen werden. */ { DBG_MEMTEST(); DBG_CHKTHIS(SfxControllerItem, 0); } //-------------------------------------------------------------------- void SfxControllerItem::DeleteFloatingWindow() { DBG_MEMTEST(); DBG_CHKTHIS(SfxControllerItem, 0); } //-------------------------------------------------------------------- void SfxStatusForwarder::StateChanged ( sal_uInt16 nSID, // des ausl"osenden Slot SfxItemState eState, // von 'pState' const SfxPoolItem* pState // Slot-Status, ggf. 0 oder IsInvalidItem() ) { pMaster->StateChanged( nSID, eState, pState ); } //-------------------------------------------------------------------- SfxStatusForwarder::SfxStatusForwarder( sal_uInt16 nSlotId, SfxControllerItem& rMaster ): SfxControllerItem( nSlotId, rMaster.GetBindings() ), pMaster( &rMaster ) { } //-------------------------------------------------------------------- SfxItemState SfxControllerItem::GetItemState ( const SfxPoolItem* pState /* Pointer auf das , dessen Status erfragt werden soll. */ ) /* [Beschreibung] Statische Methode zum Ermitteln des Status des SfxPoolItem-Pointers, in der Methode zu verwenden. [R"uckgabewert] SfxItemState SFX_ITEM_UNKNOWN Enabled, aber keine weitere Statusinformation verf"ugbar. Typisch f"ur s, die allenfalls zeitweise disabled sind, aber ihre Darstellung sonst nicht "andern. SFX_ITEM_DISABLED Disabled und keine weiter Statusinformation verf"ugbar. Alle anderen ggf. angezeigten Werte sollten auf den Default zur"uckgesetzt werden. SFX_ITEM_DONTCARE Enabled aber es waren nur uneindeutige Werte verf"ugbar (also keine, die abgefragt werden k"onnen). SFX_ITEM_AVAILABLE Enabled und mit verf"ugbarem Wert, der von 'pState' erfragbar ist. Der Typ ist dabei im gesamten Programm eindeutig und durch den Slot festgelegt. */ { return !pState ? SFX_ITEM_DISABLED : IsInvalidItem(pState) ? SFX_ITEM_DONTCARE : pState->ISA(SfxVoidItem) && !pState->Which() ? SFX_ITEM_UNKNOWN : SFX_ITEM_AVAILABLE; } //-------------------------------------------------------------------- SfxMapUnit SfxControllerItem::GetCoreMetric() const /* [Beschreibung] Holt vom zust"andigen Pool die Ma\seinheit ab, in der das Status-Item vorliegt. */ { SfxStateCache *pCache = pBindings->GetStateCache( nId ); SfxDispatcher *pDispat = pBindings->GetDispatcher_Impl(); if ( !pDispat ) { SfxViewFrame* pViewFrame = SfxViewFrame::Current(); if ( !pViewFrame ) SfxViewFrame::GetFirst(); if ( pViewFrame ) pDispat = pViewFrame->GetDispatcher(); } if ( pDispat && pCache ) { const SfxSlotServer *pServer = pCache->GetSlotServer( *pDispat ); if ( pServer ) { SfxShell *pSh = pDispat->GetShell( pServer->GetShellLevel() ); SfxItemPool &rPool = pSh->GetPool(); sal_uInt16 nWhich = rPool.GetWhich( nId ); // invalidate slot and its message|slot server as 'global' information // about the validated message|slot server is not made available pCache->Invalidate( sal_True ); return rPool.GetMetric( nWhich ); } } DBG_WARNING( "W1: Can not find ItemPool!" ); return SFX_MAPUNIT_100TH_MM; } //------------------------------------------------------------------------ #ifdef _MSC_VER #pragma optimize("g",off) #endif