UIScrollView 是使用率極高卻又常被誤解的元件。誤解多半來自一個事實:contentSize 沒設對,畫面就不會動。這篇從實作一路整理到屬性對照表。
#import <UIKit/UIKit.h>
@interface Activity01ViewController : UIViewController <UIScrollViewDelegate> {
UIScrollView *myscrollview;
}
@property (nonatomic, retain) UIScrollView *myscrollview;
@end
- (void)viewDidLoad {
[super viewDidLoad];
myscrollview = [[UIScrollView alloc]
initWithFrame:CGRectMake(0.0, 44, 768, 1004)];
myscrollview.directionalLockEnabled = YES; // 只能單一方向滑動
myscrollview.pagingEnabled = NO; // 是否整頁翻動
myscrollview.backgroundColor = [UIColor blackColor];
myscrollview.showsVerticalScrollIndicator = YES;
myscrollview.indicatorStyle = UIScrollViewIndicatorStyleWhite;
myscrollview.showsHorizontalScrollIndicator = NO;
myscrollview.delegate = self;
// 關鍵:contentSize 決定可滾動範圍
CGSize newSize = CGSizeMake(self.view.frame.size.width,
self.view.frame.size.height + 1);
[myscrollview setContentSize:newSize];
UIImageView *myimage = [[UIImageView alloc]
initWithImage:[UIImage imageNamed:@"Activity01.png"]];
[myimage setFrame:CGRectMake(0, 0, 768, 1004)];
[myscrollview addSubview:myimage];
[self.view addSubview:myscrollview];
}
範例中把 contentSize 的高度設為 view 高度 +1,就是為了剛好產生一點點可滾動空間。實務上 contentSize 通常應該等於內容子視圖的實際尺寸。
小技巧:若不想讓 scrollView 上下滑動,把 contentSize 的高度設為 0 即可:scrollview.contentSize = CGSizeMake(你要的長度, 0);
#pragma mark UIScrollViewDelegate
// 只要滾動了就會觸發(包含程式碼設定 contentOffset)
- (void)scrollViewDidScroll:(UIScrollView *)scrollView {
NSLog(@"ContentOffset x is %f, y is %f",
scrollView.contentOffset.x, scrollView.contentOffset.y);
}
// 開始拖曳
- (void)scrollViewWillBeginDragging:(UIScrollView *)scrollView;
// 結束拖曳;decelerate 表示是否還會繼續滑行
- (void)scrollViewDidEndDragging:(UIScrollView *)scrollView
willDecelerate:(BOOL)decelerate;
// 即將開始減速
- (void)scrollViewWillBeginDecelerating:(UIScrollView *)scrollView;
// 減速結束(手指再次觸碰也會中斷減速)
- (void)scrollViewDidEndDecelerating:(UIScrollView *)scrollView;
// 由程式碼觸發的捲動動畫結束時
- (void)scrollViewDidEndScrollingAnimation:(UIScrollView *)scrollView;
// 回傳要縮放哪個子視圖(必須是 scrollView 的子視圖)
- (UIView *)viewForZoomingInScrollView:(UIScrollView *)scrollView {
return viewA;
}
// 縮放結束後呼叫
- (void)scrollViewDidEndZooming:(UIScrollView *)scrollView
withView:(UIView *)view
atScale:(float)scale;
// 回傳 NO 可關閉「點狀態列自動滾回頂部」的預設行為
- (BOOL)scrollViewShouldScrollToTop:(UIScrollView *)scrollView {
return YES;
}
- (void)scrollViewDidScrollToTop:(UIScrollView *)scrollView;
最後提醒:以上寫法使用 retain 與手動配置 frame,屬 MRC 時代風格。現代專案請改用 strong/weak、Auto Layout,並優先考慮直接用 UITableView 或 UICollectionView 取代手動 scrollView——除非你確實需要完全自訂的捲動行為。