Class: MPMediaPropertyPredicate

Inherits:
MPMediaPredicate show all

Overview

Use one or more MPMediaPropertyPredicate objects, or media property predicates, to define the filter in a media query to retrieve a subset of media items from the iPod library. A predicate in this context is a statement of a logical condition that you want to test each media item against. Those items that satisfy the condition are retrieved in the query result.

Instance Attribute Summary (collapse)

Class Method Summary (collapse)

Methods inherited from NSObject

#!, #!=, #!~, #, #==, #===, #=~, #Rational, #__callee__, #__method__, #__send__, #__type__, `, alloc, allocWithZone:, #autoContentAccessingProxy, autoload, autoload?, autorelease_pool, #awakeAfterUsingCoder:, binding, block_given?, caller, cancelPreviousPerformRequestsWithTarget:, cancelPreviousPerformRequestsWithTarget:selector:object:, catch, class, classFallbacksForKeyedArchiver, #classForCoder, #classForKeyedArchiver, classForKeyedUnarchiver, #clone, conformsToProtocol:, #copy, copyWithZone:, #dealloc, #define_singleton_method, description, display, #doesNotRecognizeSelector:, #dup, #enum_for, #eql?, #equal?, #extend, fail, #finalize, format, #forwardInvocation:, #forwardingTargetForSelector:, framework, #freeze, #frozen?, getpass, gets, global_variables, #init, initialize, #initialize_clone, #initialize_copy, #initialize_dup, #inspect, instanceMethodForSelector:, instanceMethodSignatureForSelector:, #instance_eval, #instance_exec, #instance_of?, #instance_variable_defined?, #instance_variable_get, #instance_variable_set, #instance_variables, instancesRespondToSelector:, isSubclassOfClass:, #is_a?, iterator?, #kind_of?, lambda, load, load_bridge_support_file, load_plist, local_variables, loop, #method, #methodForSelector:, #methodSignatureForSelector:, #methods, #mutableCopy, mutableCopyWithZone:, new, #nil?, open, p, #performSelector:onThread:withObject:waitUntilDone:, #performSelector:onThread:withObject:waitUntilDone:modes:, #performSelector:withObject:afterDelay:, #performSelector:withObject:afterDelay:inModes:, #performSelectorInBackground:withObject:, #performSelectorOnMainThread:withObject:waitUntilDone:, #performSelectorOnMainThread:withObject:waitUntilDone:modes:, print, printf, #private_methods, proc, #protected_methods, #public_method, #public_methods, #public_send, putc, puts, raise, rand, readline, readlines, #replacementObjectForCoder:, #replacementObjectForKeyedArchiver:, require, resolveClassMethod:, resolveInstanceMethod:, #respond_to?, #respond_to_missing?, select, #send, setVersion:, #singleton_methods, sprintf, srand, superclass, #taint, #tainted?, #tap, test, throw, #to_plist, #to_s, trace_var, trap, #trust, #untaint, untrace_var, #untrust, #untrusted?, version

Constructor Details

This class inherits a constructor from NSObject

Dynamic Method Handling

This class handles dynamic methods through the method_missing method in the class NSObject

Instance Attribute Details

- (MPMediaPredicateComparison) comparisonType (readonly)

The type of matching comparison that the media property predicate performs when you invoke a query. For comparison types, see “Media Property Predicate Comparison Types.”

Returns:

  • (MPMediaPredicateComparison)

- (String) property (readonly)

The property that the media property predicate uses when you invoke a query.

Returns:

- (Object) value (readonly)

The value that the media property predicate matches against when you invoke a query.

Returns:

Class Method Details

+ (MPMediaPropertyPredicate) predicateWithValue(value, forProperty:property)

Creates a media property predicate with the default comparison type. This is a convenience method that uses the default logical comparison type of MPMediaPredicateComparisonEqualTo.

Parameters:

  • predicateWithValue: (Object)

    The property value that you want to match when you query the iPod library. For example, if you specify the MPMediaItemPropertyArtist constant in the forProperty parameter, in this parameter you supply a string containing the artist name.

  • forProperty: (String)

    A so-called filterable property—one that can be used to build a media property predicate. See General Media Item Property Keys and Podcast Item Property Keys in MPMediaItem Class Reference.

Returns:

+ (MPMediaPropertyPredicate) predicateWithValue(value, forProperty:property, comparisonType:comparisonType)

Creates a media property predicate with a specified comparison type.

Parameters:

  • predicateWithValue: (Object)

    The property value that you want to match when you query the iPod library. For example, if you specify the MPMediaItemPropertyArtist constant in the forProperty parameter, in this parameter you supply a string containing the artist name.

  • forProperty: (String)

    A so-called filterable property—one that can be used to build a media property predicate. See General Media Item Property Keys and Podcast Item Property Keys in MPMediaItem Class Reference.

  • comparisonType: (MPMediaPredicateComparison)

    The logical comparison type for the predicate. See “Media Property Predicate Comparison Types.”

Returns: