Server : Apache/2.4.41 (Ubuntu) System : Linux absol.cf 5.4.0-198-generic #218-Ubuntu SMP Fri Sep 27 20:18:53 UTC 2024 x86_64 User : www-data ( 33) PHP Version : 7.4.33 Disable Function : pcntl_alarm,pcntl_fork,pcntl_waitpid,pcntl_wait,pcntl_wifexited,pcntl_wifstopped,pcntl_wifsignaled,pcntl_wifcontinued,pcntl_wexitstatus,pcntl_wtermsig,pcntl_wstopsig,pcntl_signal,pcntl_signal_get_handler,pcntl_signal_dispatch,pcntl_get_last_error,pcntl_strerror,pcntl_sigprocmask,pcntl_sigwaitinfo,pcntl_sigtimedwait,pcntl_exec,pcntl_getpriority,pcntl_setpriority,pcntl_async_signals,pcntl_unshare, Directory : /usr/include/GNUstep/Renaissance/
Upload File :
Current File : //usr/include/GNUstep/Renaissance/GSMarkupTagObject.h
/* -*-objc-*-
GSMarkupObject.h
Copyright (C) 2002 Free Software Foundation, Inc.
Author: Nicola Pero <n.pero@mi.flashnet.it>
Date: March 2002
This file is part of GNUstep Renaissance
This library is free software; you can redistribute it and/or
modify it under the terms of the GNU Library General Public
License as published by the Free Software Foundation; either
version 2 of the License, or (at your option) any later version.
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
Library General Public License for more details.
You should have received a copy of the GNU Library General Public
License along with this library; see the file COPYING.LIB.
If not, write to the Free Software Foundation,
59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
*/
#ifndef _GNUstep_H_GSMarkupTagObject
#define _GNUstep_H_GSMarkupTagObject
#ifndef GNUSTEP
# include <Foundation/Foundation.h>
#else
# include <Foundation/NSObject.h>
#endif
#include "GSMarkupCoding.h"
@class NSArray;
@class NSBundle;
@class NSDictionary;
@class GSMarkupAwaker;
@class GSMarkupLocalizer;
/* The root class of our GSMarkupTag objects. */
@interface GSMarkupTagObject : NSObject <GSMarkupCoding>
{
NSDictionary *_attributes;
NSArray *_content;
id _platformObject;
/* The following is used, if not nil, to translate localizable
* strings when creating the platform objects. */
GSMarkupLocalizer *_localizer;
/* The following is used, if not nil, to record the platformObject
* the first time that it is created. The method
* -(void)recordPlatformObject: of the _awaker must be called when
* the _platformObject is created. Later, the decoder will ask the
* _awaker to awake all platformObjects registered with it. The
* _awaker will send a awakeFromGSMarkup message to all registered
* platformObjects which respond to that message.
*/
GSMarkupAwaker *_awaker;
}
- (id) initWithAttributes: (NSDictionary *)attributes
content: (NSArray *)content;
- (NSDictionary *) attributes;
- (NSArray *) content;
/* Set the localizer of this object and all tag objects contained in
* it. */
- (void) setLocalizer: (GSMarkupLocalizer *)localizer;
/* Return a list of localizable strings for this object (and all
* objects contained into it). Might return nil if no localizable
* string is available. The default implementation loops on all
* objects in the content, and adds them to the array if they are
* strings, or calls localizableStrings if they are GSMarkupTagObject
* objects, merging the result into the array. It then calls the
* +localizableAttributes method of the class (so that subclasses can
* override it to return a list of attributes which take as value
* localizable strings), and gets the value of each of the attributes,
* and if not nil, adds it to the array.
*
* Subclasses normally want to override +localizableAttributes unless
* they need something really special in which case they can override
* it completely.
*/
- (NSArray *) localizableStrings;
/* Return an array of localizable attributes for this class, or nil if
* there are none. GSMarkupTagObject -localizableStrings implementation
* automatically uses this list to get the localizable strings from
* the attributes. The default implementation returns nil. */
+ (NSArray *) localizableAttributes;
/* Set an awaker for this object and all tag objects contained in it.
* When the platform object is created, the awaker's method
* registerPlatformObject: will be called to register the
* platformObject.
*/
- (void) setAwaker: (GSMarkupAwaker *)awaker;
/* The following method should be used to set or change the platform
* object; you should not set the _plaftormObject instance variable
* directly. This method will both set the instance variable
* _platformObject (using ASSIGN), and register the platformObject
* with the awaker, if any, so that it is awaked at the end of
* decoding. It will also deregister the previous platformObject
* if the platformObject changes.
*/
- (void) setPlatformObject: (id)object;
/* The following method should return: self for normal objects which
* are encoded/decode normally; a platform object for logic objects
* which can manage a platform object; nil for logic objects which are
* just auxiliary objects of a parent logic object and do not actually
* manage a platform object themselves alone (FIXME this last one).
*
* This method should create the platform object the first time it is
* accessed, and reuse it afterwards.
*
* The default implementation when it's called for the first time
* calls [self allocPlatformObject] to get a platform object instance
* (subclasses should override that one to alloc a platform object of
* the correct class); it then calls [self initPlatformObject:
* platformObject], which should call the appropriate initXXX: method
* of platformObject using the appropriate attributes from the
* attributes dictionary, then set ups the platformObject with
* attributes and content, and return it; it finally calls [self
* postInitPlatformObject: platformObject] for special initialization
* (such as autosizing of gui objects) which should be done at the end
* of the initialization process (subclasses should override the
* initPlatformObject: method to call the appropriate initXXX: method
* and use the appropriate attributes - for example a window would use
* resizable=YES|NO etc in the init).
*/
- (id) platformObject;
/*
* Must be implemented to alloc a platform object of the appropriate
* class, and return it. The returned value must not be autoreleased.
*
* The default implementation calls +platformObjectClass to get the
* default Class of the platform object; it then checks the
* +useInstanceOfAttribute method; if it returns YES, then it checks
* the 'instanceOf' attribute of the object, and if set to a string,
* it tries to get a class with that string as name; if such a class
* exists, and is a subclass of the default Class, it is used to
* allocate the platform object. If +useInstanceOfAttribute returns
* NO, or if the 'instanceOf' attribute is not set, or if no class
* with that name exists, or if it is not a subclass of the default
* class, the default class is used to allocate the platform object.
*/
- (id) allocPlatformObject;
/*
* If the allocPlatformObject default implementation is used, this
* method is called to get the class to use to allocate the
* platformObject. It should be implemented by the subclass to return
* the appropriate class. The default implementation returns Nil,
* causing no platform object to be allocated.
*/
+ (Class) platformObjectClass;
/*
* If the platformObjectAlloc default implementation is used, this
* method is called to know if an eventual 'instanceOf' attribute in
* the tag should be read, and used to allocate the object of that
* class (instead of the class returned by +platformObjectClass),
* assuming that this class exists and is a subclass of the class
* returned by +platformObjectClass). The default implementation
* returns NO. If your subclass should support the instanceOf="xxx"
* attribute, you should override this method to return YES.
*/
+ (BOOL) useInstanceOfAttribute;
/*
* Should init the platform object passed as argument, using the
* attributes found in the _attributes dictionary, and the _content
* array. Subclasses might override if they need.
*
* The default implementation simply does return [platformObject
* init];
*/
- (id) initPlatformObject: (id)platformObject;
/*
* This is called immediately after initPlatformObject:. It can be
* used to complete initialization of the object. It is typically
* used for example by views - views need to size themselves to
* contents - this must be done *after* they have been init and all
* the content has been set up. We need a separate method for this
* because when overriding initPlatformObject: you must call super's
* implementation before the subclass' implementation (if you want to
* call super's implementation). postInitPlatformObject: is
* subclassed in a different way ... you should call super's
* implementation after the subclass' implementation (so that for
* example the view size to contents is executed last!). The default
* implementation is return platformObject.
*/
- (id) postInitPlatformObject: (id)platformObject;
/* Dynamically changing the attributes is not yet implemented - will
* be required by GUI builders such as Gorm and will likely require
* some sort of CAREFULLY DESIGNED extension/modification of the
* API. */
/* Handy method. Returns 0 if the attribute is NO (case insensitive
* compare), 1 if the attribute is YES (case insensitive compare), -1
* if the attribute is not defined.
*
* Accepts 'y', 'Y', 'yes', 'YES', 'Yes', 'yEs', 'yeS', 'YEs', 'YeS', 'yES',
* as 1.
*
* Accepts 'n', 'N', 'no', 'NO', 'No', nO' as 0.
*
* Returns -1 in all other cases (including if the attribute is not known).
*/
- (int) boolValueForAttribute: (NSString *)attribute;
/*
* Handy method. If there is a value for attribute, retrieves it,
* then localize it using the localizer. Otherwise, it returns nil.
*/
- (NSString *) localizedStringValueForAttribute: (NSString *)attribute;
@end
#endif /* _GNUstep_H_GSMarkupTagObject */
Server : Apache/2.4.41 (Ubuntu)