+ /**
+ * return the thumbnails associated with this install, but as locations
+ * on the file system, not URLs. It is assumed the order of thumbnails
+ * is consistent with the URLs returned from Package::thumbnailUrls()
+ */
+ PathList thumbnailPaths() const;
+
+ /**
+ * Set the handler to be called when the installation successfully
+ * completes.
+ *
+ * @note If the installation is already complete, the handler is called
+ * immediately.
+ */
+ Install* done(const Callback& cb);
+
+ template<class C>
+ Install* done(C* instance, void (C::*mem_func)(Install*))
+ {
+ return done(boost::bind(mem_func, instance, _1));
+ }
+
+ /**
+ * Set the handler to be called when the installation fails or is aborted.
+ *
+ * @note If the installation has already failed, the handler is called
+ * immediately.
+ */
+ Install* fail(const Callback& cb);
+
+ template<class C>
+ Install* fail(C* instance, void (C::*mem_func)(Install*))
+ {
+ return fail(boost::bind(mem_func, instance, _1));
+ }
+
+ /**
+ * Set the handler to be called when the installation either successfully
+ * completes or fails.
+ *
+ * @note If the installation is already complete or has already failed, the
+ * handler is called immediately.
+ */
+ Install* always(const Callback& cb);
+
+ template<class C>
+ Install* always(C* instance, void (C::*mem_func)(Install*))
+ {
+ return always(boost::bind(mem_func, instance, _1));
+ }
+
+ /**
+ * Set the handler to be called during downloading the installation file
+ * indicating the progress of the download.
+ *
+ */
+ Install* progress(const ProgressCallback& cb);
+
+ template<class C>
+ Install* progress(C* instance,
+ void (C::*mem_func)(Install*, unsigned int, unsigned int))
+ {
+ return progress(boost::bind(mem_func, instance, _1, _2, _3));
+ }
+