---

声明处：UIButton+AFNetworking.h

---

概述

这个分类在UIKit框架的UIButton类添加方法。分类中的方法提供支持从一个URL异步的加载远程图片和背景图片。
警告：不支持复合控件的状态值（比如UIControlStateHighlighted或UIControlStateDisabled）。

任务

获取图片下载器

• + setSharedImageDownloader:
• + sharedImageDownloader

设置图片

• - setImageForState:withURL:
• - setImageForState:withURL:placeholderImage:
• - setImageForState:withURLRequest:placeholderImage:success:failure:

设置背景图片

• - setBackgroundImageForState:withURL:
• - setBackgroundForState:withURL:placeholderImage:
• - setBackgroundImageForState:withURLRequest:placeholderImage:success:failure:

取消图片下载

• - cancelImageDownloadTaskForState:
• - cancelBackgroundImageDownloadTaskForState:

类方法

setSharedImageDownloader:

+ (void)setSharedImageDownloader:(AFImageDownloader *)imageDownloader

讨论

设置共享的图片下载器用来下载图片。

参数

imageDownloader

共享图片下载器用来下载图片。

声明处

UIButton+AFNetworking.h

sharedImageDownloader

+ (AFImageDownloader *)sharedImageDownloader

讨论

共享图片下载器用来下载图片。

声明处

UIButton+AFNetworking.h

实例方法

cancelBackgroundImageDownloadTaskForState:

- (void)cancelBackgroundImageDownloadTaskForState:(UIControlState)state

讨论

取消任何正在执行等待接受指定控制状态的背景图任务，如果有存在的话。

参数

state

控制状态。

声明处

UIButton+AFNetworking.h

cancelImageDownloadTaskForState:

- (void)cancelImageDownloadTaskForState:(UIControlState)state

讨论

取消任何正在执行等待接受指定控制状态的背景任务，如果有存在的话。

参数

state

控制状态

声明处

UIButton+AFNetworking.h

setBackgroundImageForState:withURL:

- (void)setBackgroundImageForState:(UIControlState)state withURL:(NSURL *)url

讨论

从指定的URL异步下载一张图片，当请求已经完成时，设置这张图片为背景图的指定状态。任何之前的用来接收背景图的请求都会被取消。

如果背景图已经在本地缓存，背景图将立即设置，否则指定的占位背景图将立即设置，此时一旦请求完成，远程的背景图将设置。

参数

state

控制状态

url

背景图请求的URL。

声明处

UIButton+AFNetworking.h

setBackgroundImageForState:withURL:placeholderImage:

- (void)setBackgroundImageForState:(UIControlState)state withURL:(NSURL *)url placeholderImage:(nullable UIImage *)placeholderImage

讨论

从指定的URL异步下载一张图片，一旦请求完成，设置图片为指定状态的背景图。接受方的之前任何图片请求将会被取消。

如果图片缓存在本地，立即设置图片，否者指定的占位图片将会立即设置，同时一旦请求完成远程的图片会被设置。

参数

state

控制状态。

url

背景图请求使用的URL。

placeholderImage

背景图被初始设置，直到背景图请求完成。如果为nil，按钮将不会改变它的背景图直到背景图请求完成。

声明处

UIButton+AFNetworking.h

setBackgroundImageForState:withURLRequest:placeholderImage:success:failure:

- (void)setBackgroundImageForState:(UIControlState)state withURLRequest:(NSURLRequest *)urlRequest placeholderImage:(nullable UIImage *)placeholderImage success:(nullable void ( ^ ) ( NSURLRequest *request , NSHTTPURLResponse *_Nullable response , UIImage *image ))success failure:(nullable void ( ^ ) ( NSURLRequest *request , NSHTTPURLResponse *_Nullable response , NSError *error ))failure

讨论

从指定的URL异步下载一张图片，一旦请求完成，设置图片为指定状态的背景图。接受方的之前任何图片请求将会被取消。

如果图片缓存在本地，立即设置图片，否者指定的占位图片将会立即设置，同时一旦请求完成远程的图片会被设置。

如果指定了成功的块，在返回之前块的职责是设置按钮图片。如果没有指定成功的块，提供默认方式使用setBackgroundImage:forState:来设置图片。

参数

state

控制状态。

urlRequest

图片请求使用URL请求。

placeholderImage

背景图被初始设置，直到背景图请求完成。如果为nil，按钮将不会改变它的背景图直到背景图请求完成。

success

一个块当图片任务成功完成时被执行。这个块没有返回值，有3个参数：客户端发送的请求，从服务器接受到响应，从请求的响应数据创建图片。如果图片是从缓存返回，响应参数将会是nil。

failure

一个块当图片数据任务不成功完成或成功完成时被执行。这个块没有返回值，有3个参数：客户端发送的请求，从服务器接收到的响应，错误对象描述网络或解析发生的错误。

声明处

UIButton+AFNetworking.h

setImageForState:withURL:

- (void)setImageForState:(UIControlState)state withURL:(NSURL *)url

讨论

从指定的URL异步下载一张图片，一旦请求完成，设置图片为指定状态的背景图。接受方的之前任何图片请求将会被取消。

如果图片缓存在本地，立即设置图片，否者指定的占位图片将会立即设置，同时一旦请求完成远程的图片会被设置。

参数

state

控制状态。

url

图片请求使用的

声明处

UIButton+AFNetWorking.h

setImageForState:withURL:placeholderImage:

- (void)setImageForState:(UIControlState)state withURL:(NSURL *)url placeholderImage:(nullable UIImage *)placeholderImage

讨论

从指定的URL异步下载一张图片，一旦请求完成，设置图片为指定状态的背景图。接受方的之前任何图片请求将会被取消。

如果图片缓存在本地，立即设置图片，否者指定的占位图片将会立即设置，同时一旦请求完成远程的图片会被设置。

参数

state

控制状态。

url

图片请求使用的

placeholderImage

背景图被初始设置，直到背景图请求完成。如果为nil，按钮将不会改变它的背景图直到背景图请求完成。

声明处

UIButton+AFNetworking.h

setImageForState:withURLRequest:placeholderImage:success:failure:

- (void)setImageForState:(UIControlState)state withURLRequest:(NSURLRequest *)urlRequest placeholderImage:(nullable UIImage *)placeholderImage success:(nullable void ( ^ ) ( NSURLRequest *request , NSHTTPURLResponse *_Nullable response , UIImage *image ))success failure:(nullable void ( ^ ) ( NSURLRequest *request , NSHTTPURLResponse *_Nullable response , NSError *error ))failure

讨论

从指定的URL异步下载一张图片，一旦请求完成，设置图片为指定状态的背景图。接受方的之前任何图片请求将会被取消。

如果图片缓存在本地，立即设置图片，否者指定的占位图片将会立即设置，同时一旦请求完成远程的图片会被设置。

如果指定一个成功的块，在返回之前这个块的职责是设置按钮的图片。如果没有指定一个成功的块，提供设置图片的默认方式setImage:forState。

参数

state

控制状态。

urlRequest

图片请求使用的URL请求。

placeholderImage

背景图被初始设置，直到背景图请求完成。如果为nil，按钮将不会改变它的背景图直到背景图请求完成。

success

一个块当图片任务成功完成时被执行。这个块没有返回值，有3个参数：客户端发送的请求，从服务器接受到响应，从请求的响应数据创建图片。如果图片是从缓存返回，响应参数将会是nil。

failure

一个块当图片数据任务不成功完成或成功完成时被执行。这个块没有返回值，有3个参数：客户端发送的请求，从服务器接收到的响应，错误对象描述网络或解析发生的错误。

声明处

UIButton+AFNetworking.h

// END