sogo/UI/Common/UIxToolbar.m

/*
  Copyright (C) 2004-2005 SKYRIX Software AG

  This file is part of OpenGroupware.org.

  OGo is free software; you can redistribute it and/or modify it under
  the terms of the GNU Lesser General Public License as published by the
  Free Software Foundation; either version 2, or (at your option) any
  later version.

  OGo 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 OGo; see the file COPYING.  If not, write to the
  Free Software Foundation, 59 Temple Place - Suite 330, Boston, MA
  02111-1307, USA.
*/

#if LIB_FOUNDATION_LIBRARY
#  include <Foundation/exceptions/GeneralExceptions.h>
#elif NeXT_Foundation_LIBRARY || COCOA_Foundation_LIBRARY
#  include <NGExtensions/NGObjectMacros.h>
#  include <NGExtensions/NSString+Ext.h>
#endif

#include <NGExtensions/NGExtensions.h>
#include <NGObjWeb/NGObjWeb.h>
#include <NGObjWeb/SoObjects.h>

#include <SOGoUI/UIxComponent.h>

@class NSArray, NSDictionary;

@interface UIxToolbar : UIxComponent
{
  NSArray      *toolbarConfig;
  NSArray      *toolbarGroup;
  NSDictionary *buttonInfo;
}
@end

#include <NGObjWeb/SoComponent.h>

@implementation UIxToolbar

- (void)dealloc {
  [self->toolbarGroup  release];
  [self->toolbarConfig release];
  [self->buttonInfo    release];
  [super dealloc];
}

/* notifications */

- (void)sleep {
  [self->toolbarGroup  release]; self->toolbarGroup  = nil;
  [self->toolbarConfig release]; self->toolbarConfig = nil;
  [self->buttonInfo    release]; self->buttonInfo    = nil;
  [super sleep];
}

/* accessors */

- (void)setToolbarGroup:(id)_group {
  ASSIGN(self->toolbarGroup, _group);
}

- (id)toolbarGroup {
  return self->toolbarGroup;
}

- (void)setButtonInfo:(id)_info {
  ASSIGN(self->buttonInfo, _info);
}

- (id)buttonInfo {
  return self->buttonInfo;
}

/* toolbar */

- (WOResourceManager *)pageResourceManager {
  WOResourceManager *rm;
  
  if ((rm = [[[self context] page] resourceManager]) != nil)
    return rm;
  
  return [[self application] resourceManager];
}

- (id) pathToResourceNamed: (NSString *) name
{
  WOResourceManager *rm;
  NSRange  r;
  NSString *fw, *rn;

  r = [name rangeOfString: @"/"];
  if (r.length > 0)
    {
      fw = [name substringToIndex: r.location];
      rn = [name substringFromIndex: (r.location + r.length)];
    }
  else
    {
      rn = name;
      fw = nil;
    }
  
  rm = [self pageResourceManager];

  return [rm pathForResourceNamed: rn inFramework: fw 
	     languages: [[self context] resourceLookupLanguages]];
}

- (id)loadToolbarConfigFromResourceNamed:(NSString *)_name {
  /*
    Note: we cannot cache by name because we don't know how the resource
          manager will look up the name.
	  Both, the clientObject and the page might be different.
	  
	  Of course the resourcemanager will cache the resource path and we
	  cache the parsed content for a given path;
  */
  static NSMutableDictionary *pathToConfig = nil;
  NSDictionary *tb;
  NSString *path;

  path = [self pathToResourceNamed: _name];
  if (path == nil) {
    [self errorWithFormat:@"Did not find toolbar resource: %@", _name];
    return nil;
  }

  if ((tb = [pathToConfig objectForKey:path]) != nil)
    return [tb isNotNull] ? tb : nil;
  
  if ((tb = [NSArray arrayWithContentsOfFile:path]) == nil)
    [self errorWithFormat:@"Could not load toolbar resource: %@", _name];

  if (pathToConfig == nil)
    pathToConfig = [[NSMutableDictionary alloc] initWithCapacity:32];
  [pathToConfig setObject:(tb ? tb : (id)[NSNull null]) forKey:path];

  return tb;
}

- (id)toolbarConfig {
  id tb;
  
  if (self->toolbarConfig != nil)
    return [self->toolbarConfig isNotNull] ? self->toolbarConfig : nil;
  
  tb = [[self clientObject] lookupName:@"toolbar" inContext:[self context]
			    acquire:NO];
  if ([tb isKindOfClass:[NSException class]]) {
    [self errorWithFormat:
            @"not toolbar configuration found on SoObject: %@ (%@)",
            [self clientObject], [[self clientObject] soClass]];
    self->toolbarConfig = [[NSNull null] retain];
    return nil;
  }
  
  if ([tb isKindOfClass:[NSString class]])
    tb = [self loadToolbarConfigFromResourceNamed:tb];
  
  self->toolbarConfig = [tb retain];
  return self->toolbarConfig;
}

/* labels */

- (NSString *)buttonLabel {
  WOResourceManager *rm;
  NSString          *key, *label;
  
  key = [[self buttonInfo] valueForKey:@"label"];
  
  /* lookup resource manager */
  
  if ((rm = [self pageResourceManager]) == nil)
    rm = [[WOApplication application] resourceManager];
  if (rm == nil)
    [self warnWithFormat:@"missing resource manager!"];
  
  /* lookup string */
  
  label = [rm stringForKey:key inTableNamed:nil withDefaultValue:key
              languages:[[self context] resourceLookupLanguages]];
  return label;
}

- (id) buttonImage {
  WOResourceManager *rm;
  NSString *image;

  rm = [self pageResourceManager];
  image = [buttonInfo objectForKey: @"image"];
  if (image && [image length] > 0)
    image = [rm urlForResourceNamed: image];

  return image;
}

/* enable/disable buttons */

- (BOOL)isButtonEnabled {
  // TODO: replace 'enabled' with WOAssociation when this gets a dynamic
  //       element
  NSString *onOffKey;
  
  if ((onOffKey = [[self buttonInfo] valueForKey:@"enabled"]) == nil)
    return YES;
  
  return [[[[self context] page] valueForKeyPath:onOffKey] boolValue];
}

- (BOOL) isLastGroup {
  return ([toolbarConfig indexOfObject: toolbarGroup]
	  == ([toolbarConfig count] - 1));
}

- (BOOL) hasButtons
{
  id tbConfig;
  unsigned int count, max, amount;

  tbConfig = [self toolbarConfig];

  amount = 0;
  max = [tbConfig count];
  for (count = 0; count < max; count++)
    amount += [[tbConfig objectAtIndex: count] count];

  return (amount > 0);
}

@end /* UIxToolbar */