文档未记录的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]];
}
本文出自 “ArthurChen” 博客，请务必保留此出处http://arthurchen.blog.51cto.com/2483760/575671