git.sesse.net Git - vlc/blob - projects/macosx/framework/Headers/Public/VLCMediaList.h

   1 /*****************************************************************************
   2  * VLCMediaList.h: VLCKit.framework VLCMediaList header
   3  *****************************************************************************
   4  * Copyright (C) 2007 Pierre d'Herbemont
   5  * Copyright (C) 2007 the VideoLAN team
   6  * $Id$
   7  *
   8  * Authors: Pierre d'Herbemont <pdherbemont # videolan.org>
   9  *
  10  * This program is free software; you can redistribute it and/or modify
  11  * it under the terms of the GNU General Public License as published by
  12  * the Free Software Foundation; either version 2 of the License, or
  13  * (at your option) any later version.
  14  *
  15  * This program is distributed in the hope that it will be useful,
  16  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  17  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  18  * GNU General Public License for more details.
  19  *
  20  * You should have received a copy of the GNU General Public License
  21  * along with this program; if not, write to the Free Software
  22  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston MA 02110-1301, USA.
  23  *****************************************************************************/
  24
  25 #import "VLCMedia.h"
  26
  27 /* Notification Messages */
  28 extern NSString * VLCMediaListItemAdded;
  29 extern NSString * VLCMediaListItemDeleted;
  30
  31 @class VLCMedia;
  32 @class VLCMediaList;
  33
  34 /**
  35  * TODO: Documentation VLCMediaListDelegate
  36  */
  37 @protocol VLCMediaListDelegate
  38 /**
  39  * TODO: Documentation - [VLCMediaListDelegate mediaList:mediaAdded:atIndex:]
  40  */
  41 - (void)mediaList:(VLCMediaList *)aMediaList mediaAdded:(VLCMedia *)media atIndex:(NSInteger)index;
  42
  43 /**
  44  * TODO: Documentation - [VLCMediaListDelegate mediaList:mediaRemovedAtIndex:]
  45  */
  46 - (void)mediaList:(VLCMediaList *)aMediaList mediaRemovedAtIndex:(NSInteger)index;
  47 @end
  48
  49 /**
  50  * TODO: Documentation VLCMediaList
  51  */
  52 @interface VLCMediaList : NSObject
  53 {
  54     void * p_mlist;                                 //< Internal instance of media list
  55     id <VLCMediaListDelegate,NSObject> delegate;    //< Delegate object
  56     /* We need that private copy because of Cocoa Bindings, that need to be working on first thread */
  57     NSMutableArray * cachedMedia;                   //< Private copy of media objects.
  58 }
  59
  60 /* Operations */
  61 /**
  62  * TODO: Documentation - [VLCMediaList lock]
  63  */
  64 - (void)lock;
  65
  66 /**
  67  * TODO: Documentation - [VLCMediaList unlock]
  68  */
  69 - (void)unlock;
  70
  71 /**
  72  * TODO: Documentation - [VLCMediaList addMedia:]
  73  */
  74 - (NSInteger)addMedia:(VLCMedia *)media;
  75
  76 /**
  77  * TODO: Documentation - [VLCMediaList insertMedia:atIndex:]
  78  */
  79 - (void)insertMedia:(VLCMedia *)media atIndex:(NSInteger)index;
  80
  81 /**
  82  * TODO: Documentation - [VLCMediaList removeMediaAtIndex:]
  83  */
  84 - (void)removeMediaAtIndex:(NSInteger)index;
  85
  86 /**
  87  * TODO: Documentation - [VLCMediaList mediaAtIndex:]
  88  */
  89 - (VLCMedia *)mediaAtIndex:(NSInteger)index;
  90
  91 /**
  92  * TODO: Documentation - [VLCMediaList indexOfMedia:]
  93  */
  94 - (NSInteger)indexOfMedia:(VLCMedia *)media;
  95
  96 /* Properties */
  97 /**
  98  * TODO: Documentation VLCMediaList.count
  99  */
 100 @property (readonly) NSInteger count;
 101
 102 /**
 103  * TODO: Documentation VLCMediaList.delegate
 104  */
 105 @property (assign) id delegate;
 106
 107 /**
 108  * TODO: Documentation VLCMediaList.isReadOnly
 109  */
 110 @property (readonly) BOOL isReadOnly;
 111
 112 @end