文档未记录的API之UICalloutView

 

如果你在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]]; }