It is a subclass of
UIImageView that allows you to customize the alignment of the displayed image inside the view's frame.
This works even if the
contentMode is set to
Because there are many cool categories built on top of UIImageView. Subclassing a standard UIView would mean losing them.
For example, AFNetworking's async
UIImageView category works perfectly using this container class, and you don't have to worry about a thing.
UIImageViewAligned will create a inner
UIImageView which will actually hold the image displayed.
The main class then just repositions this inner
UIImageView to achieve your desired alignment.
At runtime, you can change the image, contentMode or alignment and the image will reposition itself correctly.
image property of UIImageViewAligned is overwritten to forward the calls to the inner
UIImageView, so you can just drag-n-drop into your app.
From what I tested, it works on iOS 6.0+. Also, it supports autorotation and will reposition the image correctly.
You can setup the alignment from Interface Builder using the
Identity Inspector tab for the UIImageViewAligned.
There, you can add custom boolean properties that will be set when the view is instantiated.
The possible boolean names are:
Below is a screenshot of an example. You will not get an immediate feedback in IB regarding your alignment, but it will work at runtime.