如果你在iPhone上使用过Google Map,你可能在实战中见过UICalloutView实例。虽然它们的名称如此,但是它们是一种UIControl实例。它们是文档中未记录的,但在UIKit框架中可用。
标注视图指向屏幕上的某些内容。它们在使用附加的扩展按钮移动到另一个消息之前,可以显示一个临时消息。下图显示了带有几个标注视图的屏幕,其中有些标注视图显示它们的源(临时)消息,其他标注视图显示最终消息。
由于类是文档中未记录的,因此需要定义头文件。下面是UICalloutView类定义。它还不完整,不过它提供了足够的功能使你能够在程序中有效地使用这个类。
@interface UICalloutView : UIControl
- (UICalloutView *)initWithFrame:(struct CGRect)aFrame;
- (void)fadeOutWithDuration:(float)duration;
- (void)setTemporaryTitle:(NSString *)fp8;
- (NSString *)temporaryTitle;
- (void)setTitle:(NSString *)fp8;
- (NSString *)title;
- (void)setSubtitle:(NSString *)fp8;
- (NSString *)subtitle;
- (void)addTarget:(id)target action:(SEL)selector;
- (void)removeTarget:(id)target;
- (void)setDelegate:(id)delegate;
- (id)delegate;
- (void)setAnchorPoint:(struct CGPoint)aPoint boundaryRect:(struct CGRect)aRect animate:(BOOL)yorn;
@end
要创建一个标注,需要传递一个定位点--即标注指向的坐标--和一个广义(generalized)边界矩形。据我所知,这些限制完全被忽略了。
标注使用两个标题:一个临时标题和一个普通标题。当添加一个临时标题时,此标题显示大约一秒钟的时间,然后会变为普通标题,即带有扩展按钮的标题。
通过调用addTarget: action:方法,为扩展按钮设置目标。当扩展按钮被点击时,就调用传递的选择程序。这里不为标注上的用户点击计数,iPhone忽略了它们。因此,如 果希望在出现一个新标注时除去现有标注,应该由你来消除它。可以快速地使用fadeOutWithDuration:方法并指定渐没时间。
下面是使用的办法
- (void) hideDisclosure: (UIPushButton *) calloutButton
{
UICalloutView *callout = (UICalloutView *)[calloutButton superview];
[callout fadeOutWithDuration:1.0f];
}
- (UICalloutView *) buildDisclosure
{
UICalloutView *callout = [[[UICalloutView alloc] initWithFrame:CGRectZero] autorelease];
callout.contentVerticalAlignment = UIControlContentVerticalAlignmentCenter;
callout.contentHorizontalAlignment = UIControlContentHorizontalAlignmentCenter;
// You can easily customize the information and the target
[callout setTemporaryTitle:@"You Tapped Here!"];
[callout setTitle:@"More Info..."];
[callout addTarget:self action:@selector(hideDisclosure:)];
return callout;
}
- (void) showDisclosureAt:(CGPoint) aPoint
{
UICalloutView *callout = [self buildDisclosure];
[self addSubview:callout];
[callout setAnchorPoint:aPoint boundaryRect:CGRectMake(0.0f, 0.0f, 320.0f, 100.0f) animate:YES];
}
- (void) touchesBegan:(NSSet*)touches withEvent:(UIEvent*)event
{
[self showDisclosureAt:[[touches anyObject] locationInView:self]];
}