我一直在努力将我的自定义样式(示例)应用于我正在构建的OSX桌面应用程序，我想知道这样做的范例/习惯用法是什么。
- 我正在使用X/Nibs来布置窗口上的组件
- 我正在将组件的类设置为开箱即用组件的自定义子类(例如
NSTextField、NSButton和NSPopUpButton) - 我在一些层中覆盖
viewWillDraw，在另一些层中重写init?，并使它们全部为wantsLayer，并在这些层上设置属性
这看起来非常笨拙，而且有些视觉上的东西无法用这种方式处理，比如向NSTextField添加填充我应该创建一个(@Willeke在评论中告诉我，可以选择控件的单元格，因此可以通过再次单击控件来分配自定义单元格类)NSTextFieldCell子类并实例化一个并将其设置到单元格中吗？这样做会完全打断文本字段。我看到其他地方应该将NSButtonCell作为子类，但我不能将其指定为X/Nib中按钮的类
很多人都在描述如何通过引用组件来对viewDidLoad中的视觉组件进行某些更改，如果你有适用于项目中所有组件的按钮/文本字段样式，这似乎非常乏味。我在子类化方面所做的每一次视觉更改似乎都是一场噩梦，而且对于不同组件的视觉更改没有任何模式。如果你想让你的代码可重用，那么子类似乎是任何规模的项目的最佳选择，但我遗漏了什么吗？我还缺少其他模式或习语吗？
将NSTextFieldCell子类化是最好的选择，但这肯定是一场漫长的战斗。像Willeke-sez一样，更改XIB中单元格的类。
我使用BGHUDAppKit作为起点，多年来进行了主要的MOD/升级。
FWIW这里是我当前版本的BGHUDTextFieldCell.mm，它使用了一堆我自己的分类方法，比如attrStringWithColor，但总体思路应该很清楚。
处理聚焦环动画特别麻烦。绘制自定义聚焦环的唯一方法是子类化很多东西，包括NSTextField，可能还有它的超视图，这样你就可以劫持默认的NSTextView聚焦环。但是，我强烈建议不要对NSTextView本身进行子类化。。。请参阅下面的setupFieldEditorColors。
// BGHUDTextFieldCell.m
// BGHUDAppKit
//
// Created by BinaryGod on 6/2/08.
//
// Copyright (c) 2008, Tim Davis (BinaryMethod.com, binary.god@gmail.com)
// All rights reserved.
//
// Redistribution and use in source and binary forms, with or without modification,
// are permitted provided that the following conditions are met:
//
// Redistributions of source code must retain the above copyright notice, this
// list of conditions and the following disclaimer.
//
// Redistributions in binary form must reproduce the above copyright notice,
// this list of conditions and the following disclaimer in the documentation and/or
// other materials provided with the distribution.
//
// Neither the name of the BinaryMethod.com nor the names of its contributors
// may be used to endorse or promote products derived from this software without
// specific prior written permission.
//
// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS AS IS AND
// ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
// WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
// IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT,
// INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
// BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA,
// OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
// WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
// ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
// POSSIBILITY OF SUCH DAMAGE.
#import "BGHUDTextFieldCell.h"
#import "VNSColorCategory.h"
#import "BGThemeMbox.h"
@interface BGHUDTextFieldCell (Private)
- (void)doInit;
- (NSRect)_focusRingFrameForFrame:(NSRect)aRect cellFrame:(NSRect)cellFrame; // bug fix
@end
@implementation BGHUDTextFieldCell
@synthesize themeKey;
@synthesize LayerKey;
@synthesize defaultTextColor;
@synthesize isVerticallyCentered;
@synthesize fillsBackground;
//@synthesize LayerKey;
#pragma mark Drawing Functions
- (id)initTextCell:(NSString *)aString {
self = [super initTextCell: aString];
if(self) {
self.themeKey = @"gradientTheme";
[self doInit];
}
return self;
}
- (id)initWithCoder:(NSCoder *) aDecoder {
self = [super initWithCoder: aDecoder];
if(self) {
if([aDecoder containsValueForKey: @"themeKey"]) {
self.themeKey = [aDecoder decodeObjectForKey: @"themeKey"];
} else {
self.themeKey = @"gradientTheme";
}
[self doInit];
}
return self;
}
- (void)doInit
{
self.defaultTextColor = [[[BGThemeManager keyedManager] themeForKey: self.themeKey] textColor];
[self setTextColor:self.defaultTextColor];
if([self drawsBackground]) {
fillsBackground = YES;
////NSLog( @"t%d BGHUDTextFieldCell initTextCell ignoring nib backgroundColor %@, use fillsBackground", [self tag], [self backgroundColor] );
}
else // kpk 2010... always draw background?
{
fillsBackground = NO;
}
[self setDrawsBackground: NO];
}
-(void)encodeWithCoder:(NSCoder *)aCoder {
[super encodeWithCoder: aCoder];
[aCoder encodeObject: self.themeKey forKey: @"themeKey"];
}
- ( NSRect ) adjustFrameToVerticallyCenterText: ( NSRect ) frame
{
// super would normally draw text at the top of the cell
int offset = floor ( ( NSHeight ( frame ) - ( [ [ self font ] ascender] - [ [ self font ] descender ] ) ) / 2 );
frame = NSInsetRect ( frame, 0.0, offset );
return frame;
}
- (NSText *)setUpFieldEditorAttributes:(NSText *)textObj
{
BGTheme *theTheme = [[BGThemeManager keyedManager] themeForKey: self.themeKey];
//textObj = [super setUpFieldEditorAttributes:textObj];
NSTextView *theTextView = (NSTextView *)textObj;
if ( [theTextView isKindOfClass:[NSTextView class]] )
{
//NSLog( @"t%d text view editor %@ bgcolor %@ insert color %@", [self tag], [theTextView description], [theTextView backgroundColor], [theTextView insertionPointColor] );
[BGTheme setupFieldEditorColors:theTheme editor:theTextView window:[[self controlView] window] forObject:self];
}
return textObj;
}
-(void)drawWithFrame:(NSRect)cellFrame inView:(NSView *)controlView {
waitIfNeeded(self);
if ( isVerticallyCentered ) // kpk 2013 _cFlags.vCentered = 1;
cellFrame = [ self adjustFrameToVerticallyCenterText: cellFrame ];
// kpk 2009/2010: get the fieldEditorView (NSTextView) to display properly as well.
// Also be careful not to cause continuous redraws by setting text color unnecessarily.
NSWindow *theWindow = [controlView window];
NSTextView* fieldEditorView = (NSTextView*)[theWindow fieldEditor: NO forObject: self];
id fieldEditorDelegate = [fieldEditorView delegate];
if ( [theWindow firstResponder] == fieldEditorView && fieldEditorDelegate == controlView )
{
//NSLog( @"t%d fieldEditorView bg color %@ self %@ controlView %@", [self tag], [self backgroundColor], [self description], [controlView description] );
BGTheme *theTheme = [[BGThemeManager keyedManager] themeForKey: self.themeKey];
if ( fieldEditorView )
[BGTheme setupFieldEditorColors:theTheme editor:fieldEditorView window:theWindow forObject:self];
NSRect editFrame = [fieldEditorView frame];
NSRect controlViewFrame = [controlView frame];
if ( [controlView isKindOfClass:[NSTextField class]] && NSIntersectsRect(controlViewFrame, editFrame ))
{
return;
}
}
fieldEditorView = nil; // kpk 2010: we are done with this now
//Create Path
NSBezierPath *path = [[NSBezierPath new] autorelease];
if([self bezelStyle] == NSTextFieldRoundedBezel) {
[path appendBezierPathWithArcWithCenter: NSMakePoint(cellFrame.origin.x + (cellFrame.size.height /2), cellFrame.origin.y + (cellFrame.size.height /2))
radius: cellFrame.size.height /2
startAngle: 90
endAngle: 270];
[path appendBezierPathWithArcWithCenter: NSMakePoint(cellFrame.origin.x + (cellFrame.size.width - (cellFrame.size.height /2)), cellFrame.origin.y + (cellFrame.size.height /2))
radius: cellFrame.size.height /2
startAngle: 270
endAngle: 90];
[path closePath];
} else {
// kpk 2010: not desireable for table view cells
//[path appendBezierPathWithRoundedRect: cellFrame xRadius: 3.0f yRadius: 3.0f];
//[path appendBezierPathWithRect:cellFrame];
}
//Draw Background
if(fillsBackground) {
[[[[BGThemeManager keyedManager] themeForKey: self.themeKey] textFillColor] set];
// kpk 2010: not desireable for table view cells
NSRectFill( cellFrame );
//[path fill];
}
else if ( [self isEditable] )
{
[[[[BGThemeManager keyedManager] themeForKey: self.themeKey] textFillColor] set];
[path fill];
// NSRectFill( cellFrame );
}
if([self isBezeled] || [self isBordered]) {
[NSGraphicsContext saveGraphicsState];
if([super showsFirstResponder] && [theWindow isKeyWindow] &&
([self focusRingType] == NSFocusRingTypeDefault ||
[self focusRingType] == NSFocusRingTypeExterior)) {
[[[[BGThemeManager keyedManager] themeForKey: self.themeKey] focusRing] set];
}
//Check State
if([self isEnabled]) {
[[[[BGThemeManager keyedManager] themeForKey: self.themeKey] darkStrokeColor] set];
} else {
[[[[BGThemeManager keyedManager] themeForKey: self.themeKey] disabledStrokeColor] set];
}
[path setLineWidth: 1.0f];
[path stroke];
[NSGraphicsContext restoreGraphicsState];
}
// Check to see if the attributed placeholder has been set or not
//if(![self placeholderAttributedString]) {
if(![self placeholderAttributedString] && [self placeholderString]) {
//Nope lets create it
NSDictionary *attribs = [[NSDictionary alloc] initWithObjectsAndKeys:
[[[BGThemeManager keyedManager] themeForKey: self.themeKey] placeholderTextColor] , NSForegroundColorAttributeName, nil];
//Set it
[self setPlaceholderAttributedString: [[[NSAttributedString alloc] initWithString: [self placeholderString] attributes: [attribs autorelease]] autorelease]];
}
//Adjust Frame so Text Draws correctly
switch ([self controlSize]) {
case NSRegularControlSize:
if([self bezelStyle] == NSTextFieldRoundedBezel) { // kpk 2010
cellFrame.origin.y += 1;
}
break;
case NSSmallControlSize:
if([self bezelStyle] == NSTextFieldRoundedBezel) {
cellFrame.origin.y += 1;
}
break;
case NSMiniControlSize:
if([self bezelStyle] == NSTextFieldRoundedBezel) {
cellFrame.origin.x += 1;
}
break;
default:
break;
}
[self drawInteriorWithFrame: cellFrame inView: controlView];
}
-(void)drawInteriorWithFrame:(NSRect) cellFrame inView:(NSView *) controlView {
if ( [controlView conformsToProtocol:@protocol(EditingAlignmentProtocol)] )
{
if ( [controlView isKindOfClass:[NSControl class]] && [(NSControl *)controlView currentEditor] )
{
// DLog( @"danger: skipping draw to avoid call to validateEditing!" );
return;
}
cellFrame = [(id <EditingAlignmentProtocol>)controlView editingAlignmentRect];
cellFrame = [self titleRectForBounds:cellFrame];
NSAttributedString *str = [self attributedStringValue];
[str drawInRect:cellFrame];
return;
}
[super drawInteriorWithFrame: cellFrame inView: controlView];
}
- (NSColor *)highlightColorWithFrame:(NSRect)cellFrame inView:(NSView *)controlView;
{
// Corbin Dunn (the apple author) says to return nil here
// The proper thing to do:
//
// 1. Subclass NSCell, NSTextFieldCell, or whatever other cell you want.
// 2. Override:
//
// - (NSColor *)highlightColorWithFrame:(NSRect)cellFrame inView:(NSView
// *)controlView
//
// and return nil.
//
// That is the correct thing to do for Tiger, Leopard, etc.
//
// corbin
if ( [controlView isKindOfClass: [NSTableView class]] )
return nil; // [[BGThemeMbox instance] cellHighlightColor];
return [super highlightColorWithFrame:cellFrame inView:controlView];
}
// warning mIsEditingOrSelecting is probably not used correctly when call stack is deep,
// while switching from one edit field to another
- (NSRect)drawingRectForBounds:(NSRect)aRect
{
id controlView = [self controlView];
NSRect newRect;
if ( [controlView conformsToProtocol:@protocol(EditingAlignmentProtocol)] )
newRect = [(id <EditingAlignmentProtocol>)controlView editingAlignmentRect];
else
{
newRect = [super drawingRectForBounds:aRect];
if (mIsEditingOrSelecting == NO)
{
// Get our ideal size for current text
NSSize textSize = [self cellSizeForBounds:aRect];
if ( textSize.height >= 22 && textSize.height > newRect.size.height )
{
newRect.origin.y = -(textSize.height - newRect.size.height) + 6;
newRect.size.height = textSize.height + (textSize.height - newRect.size.height);
}
}
}
return newRect;
}
// hack alert: undocumented _focusRingFrameForFrame
// this fixes a hard to reproduce bug where NSTextView fieldEditor *sometimes*
// leaves behind white clutter.
// to reproduce, have 10, 11, or 12 items in scene table, then edit xFade type.
// scene table will have white clutter.
- (NSRect)_focusRingFrameForFrame:(NSRect)aRect cellFrame:(NSRect)cellFrame
{
id ctl = [self controlView];
if ( [ctl conformsToProtocol:@protocol(EditingAlignmentProtocol)] )
return [ctl bounds];
else
return cellFrame;
}
// This method is adapted from Red Sweater Software's RSVerticallyCenteredTextField class.
// Created by Daniel Jalkut on 6/17/06.
// Copyright 2006 Red Sweater Software. All rights reserved.
// MIT License
- (void)selectWithFrame:(NSRect)aRect inView:(NSView *)controlView editor:(NSText *)textObj delegate:(id)anObject start:(NSInteger)selStart length:(NSInteger)selLength
{
if ( isVerticallyCentered ) // kpk 2013 _cFlags.vCentered replacement
aRect = [ self adjustFrameToVerticallyCenterText: aRect ];
aRect = [self drawingRectForBounds:aRect];
mIsEditingOrSelecting = YES;
[super selectWithFrame:aRect inView:controlView editor:textObj delegate:anObject start:selStart length:selLength];
mIsEditingOrSelecting = NO;
//NSLog( @"selectWithFrame %@ %@", controlView, textObj );
}
// This method is adapted from Red Sweater Software's RSVerticallyCenteredTextField class.
// Created by Daniel Jalkut on 6/17/06.
// Copyright 2006 Red Sweater Software. All rights reserved.
// MIT License
- (void)editWithFrame:(NSRect)aRect inView:(NSView *)controlView editor:(NSText *)textObj delegate:(id)anObject event:(NSEvent *)theEvent
{
if ( isVerticallyCentered ) // kpk 2013 _cFlags.vCentered replacement
aRect = [ self adjustFrameToVerticallyCenterText: aRect ];
//NSLog( @"editWithFrame %@", controlView );
aRect = [self drawingRectForBounds:aRect];
mIsEditingOrSelecting = YES;
[super editWithFrame:[self drawingRectForBounds:aRect] inView:controlView editor:textObj delegate:anObject event:theEvent];
mIsEditingOrSelecting = NO;
}
-(void)_drawKeyboardFocusRingWithFrame:(NSRect)fp8 inView:(id)fp24 {
//NSLog( @"_drawKeyboardFocusRingWithFrame" );
}
- (void)drawWithExpansionFrame:(NSRect)cellFrame inView:(NSView *)view
{
[[[[BGThemeManager keyedManager] themeForKey: @"gradientTheme"] darkStrokeColor] set];
NSRectFill(cellFrame);
[self drawInteriorWithFrame:cellFrame inView:view];
}
- (void) setAttributedColor: (NSColor *)iColor
{
NSMutableAttributedString *attrStr = [[self stringValue] attrStringWithColor: iColor];
[attrStr setAlignment: [self alignment] range:[attrStr fullRange]];
[attrStr setFont:[self font]];
[self setAttributedStringValue:attrStr];
if ( iColor )
[self setTextColor:iColor];
else if ( [self isEditable] )
[self setTextColor: [NSColor defaultTextColor]];
else
[self setTextColor:[NSColor dimTextColor]];
}
#pragma mark -
#pragma mark Helper Methods
-(void)dealloc {
[super dealloc];
}
#pragma mark -
@end
.h文件：
#import <Cocoa/Cocoa.h>
#import "BGThemeManager.h"
@protocol EditingAlignmentProtocol
- (NSRect)editingAlignmentRect; // used to align NSTextView field editor frame
- (void)setIsSettingUpFieldEditor:(bool)flag;
- (bool)isSettingUpFieldEditor;
@end
@interface BGHUDTextFieldCell : NSTextFieldCell {
BOOL fillsBackground;
NSString *themeKey;
NSString *LayerKey;
NSColor *defaultTextColor;
BOOL mIsEditingOrSelecting;
BOOL isVerticallyCentered;
}
@property (retain) NSString *themeKey;
@property (retain) NSString *LayerKey;
@property (retain) NSColor *defaultTextColor;
@property (assign) BOOL isVerticallyCentered;
@property (assign) BOOL fillsBackground;
- (void)doInit; // if overriden, must call [super doInit];
- (void) setAttributedColor: (NSColor *)iColor;
@end
setupFieldEditor
+(void)setupFieldEditorColors:(BGTheme *)iTheme editor:(NSTextView *)iFieldEditorView window:(NSWindow *)iWindow forObject:(id)anObject
{
if ( iFieldEditorView == nil )
return;
if ( !iFieldEditorView || ![iFieldEditorView isKindOfClass:[NSTextView class]] )
return;
// setup attributes such that editing in the field editor will
// occur at the exact same position as the title cell was drawn
[[iFieldEditorView textContainer] setLineFragmentPadding:2.0];
//[[iFieldEditorView layoutManager] setTypesetterBehavior:NSTypesetterBehavior_10_2_WithCompatibility];
NSRange theSelRange = [iFieldEditorView selectedRange];
@try
{
if ( [anObject respondsToSelector: @selector(themeKey)] ||
( [anObject respondsToSelector: @selector(cell)] &&
[[anObject cell] respondsToSelector: @selector(themeKey)] ))
{
//NSLog( @"theSelRange %@", NSStringFromRange(theSelRange));
NSColor *theTextColor = [iTheme textColor];
if ( [iFieldEditorView insertionPointColor] != theTextColor )
[iFieldEditorView setInsertionPointColor:theTextColor];
//if ( [iFieldEditorView textColor] != theTextColor )
//{
//NSLog( @"cell editor tc %@n change to %@", [iFieldEditorView textColor], theTextColor );
// [iFieldEditorView setTextColor: theTextColor];
//}
//NSLog( @"cell editor createFlag %d", createFlag);
//if ( ![iFieldEditorView isKindOfClass:[BGHUDTextView class]] )
// iFieldEditorView = [BGHUDTextView alloc] init
NSColor *theBgColor = [iTheme cellEditingFillColor];
if ( [iFieldEditorView backgroundColor] != theBgColor )
{
//NSLog( @"cell editor bg %@n change to %@", [iFieldEditorView backgroundColor], theBgColor );
[iFieldEditorView setBackgroundColor:theBgColor];
}
if ( [iFieldEditorView drawsBackground] == NO )
[iFieldEditorView setDrawsBackground:YES];
NSMutableDictionary *theDict = [[[iFieldEditorView selectedTextAttributes] mutableCopy] autorelease];
//NSColor *theSelTextColor = nil;
if([iWindow isKeyWindow])
{
if ( [theDict objectForKey: NSBackgroundColorAttributeName] != [iTheme selectionHighlightActiveColor] )
{
[theDict setObject: [iTheme selectionHighlightActiveColor]
forKey: NSBackgroundColorAttributeName];
//theSelTextColor = [iTheme selectionTextActiveColor];
//kpk why doesn't this work?
[theDict setObject: [iTheme selectionTextActiveColor]
forKey: NSForegroundColorAttributeName];
[iFieldEditorView setSelectedTextAttributes:theDict];
}
}
else
{
if ( [theDict objectForKey: NSBackgroundColorAttributeName] != [iTheme selectionHighlightInActiveColor] )
{
[theDict setObject: [iTheme selectionHighlightInActiveColor]
forKey: NSBackgroundColorAttributeName];
//theSelTextColor = [iTheme selectionTextInActiveColor];
//kpk why doesn't this work?
[theDict setObject: [iTheme selectionTextInActiveColor]
forKey: NSForegroundColorAttributeName];
[iFieldEditorView setSelectedTextAttributes:theDict];
}
}
/*
NSString *theStr = [iFieldEditorView string];
if ( !theStr )
return;
NSUInteger theStrLength = [theStr length];
if ( theStrLength > 0 )
[iFieldEditorView setTextColor: theTextColor
range: NSMakeRange(0, theStrLength)];
if(theSelRange.length > 0 && theSelRange.length <= theStrLength || theSelRange.location <= theStrLength && NSMaxRange(theSelRange) <= theStrLength )
{
[iFieldEditorView setTextColor: theSelTextColor
range: [iFieldEditorView selectedRange]];
}
else
{
}
*/
}
}
@catch(...)
{
//VLog::Log( kLogErrorType | kLogNoFlood, @"caught exception in setupFieldEditorColors %@", NSStringFromRange(theSelRange));
NSLog( @"caught exception in setupFieldEditorColors %@", NSStringFromRange(theSelRange) );
}
}
我最终确实对NSTextFieldCell进行了子类化，根据这个答案，我为我面临的特定问题导出了以下内容：
class TGTextFieldCell: NSTextFieldCell {
override init(imageCell image: NSImage?) {
super.init(imageCell: image)
}
override init(textCell aString: String) {
super.init(textCell: aString)
}
required init?(coder aDecoder: NSCoder) {
super.init(coder: aDecoder)
}
override func drawingRectForBounds(theRect: NSRect) -> NSRect {
let rectInset = NSMakeRect(theRect.origin.x + 7, theRect.origin.y + 7, theRect.size.width, theRect.size.height)
return super.drawingRectForBounds(rectInset)
}
}
定制视图似乎仍然比需要的复杂得多(例如，继续定制焦点样式)，但这是一个我还没有听到好答案的问题。