DejalAppKitCategories is a collection of categories for AppKit on OS X, to add useful methods to classes like NSMenu, NSTableView, NSTextView, and others.
Objective-C
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
.gitignore
License.txt
NSButton+Dejal.h
NSButton+Dejal.m
NSImage+Dejal.h
NSImage+Dejal.m
NSMenu+Dejal.h
NSMenu+Dejal.m
NSOutlineView+Dejal.h
NSOutlineView+Dejal.m
NSPopUpButton+Dejal.h
NSPopUpButton+Dejal.m
NSProgressIndicator+Dejal.h
NSProgressIndicator+Dejal.m
NSScreen+Dejal.h
NSScreen+Dejal.m
NSSplitView+Dejal.h
NSSplitView+Dejal.m
NSTableView+Dejal.h
NSTableView+Dejal.m
NSTextField+Dejal.h
NSTextField+Dejal.m
NSTextView+Dejal.h
NSTextView+Dejal.m
NSToolbar+Dejal.h
NSToolbar+Dejal.m
NSView+Dejal.h
NSView+Dejal.m
NSViewController+Dejal.h
NSViewController+Dejal.m
NSWindow+Dejal.h
NSWindow+Dejal.m
README.markdown

README.markdown

DejalAppKitCategories

DejalAppKitCategories is a collection of categories for AppKit on OS X, to add useful methods to classes like NSMenu, NSTableView, NSTextView, and others.

Donations

I wrote DejalAppKitCategories for my own use, but I'm making it available for the benefit of the Mac developer community.

If you find it useful, a donation via PayPal (or something from my Amazon.com Wish List) would be very much appreciated. Appropriate links can be found on the Dejal Developer page:

http://www.dejal.com/developer

Latest Version

You can find the latest version of this code via the GitHub repository:

https://github.com/Dejal/DejalAppKitCategories

For news on updates, also check out the Dejal Developer page or the Dejal Blog filtered for Dejal categories posts:

http://www.dejal.com/blog/dejalcategories

Environment & Requirements

  • OS X 10.10. Most methods may work in older OS versions.
  • Objective-C language.
  • ARC.
  • Some categories depend on the DejalFoundationCategories.

Features

  • NSButton+Dejal: A text color property and a method to display a menu, plus methods to manage radio buttons without the informally-deprecated NSMatrix.
  • NSImage+Dejal: Methods to draw flipped images, apply a badge or tint, or get a PNG representation.
  • NSMenu+Dejal: Methods to add and remove items.
  • NSOutlineView+Dejal: Methods for selected items and displaying a menu.
  • NSPopUpButton+Dejal: Methods to add and select items.
  • NSScreen+Dejal: Screen name methods.
  • NSSplitView+Dejal: Methods for split positions and collapsing and expanding.
  • NSTableView+Dejal: Selection, column and copying methods.
  • NSTextField+Dejal: Methods to set values, synchronize with a slider, and resize the window (using autoresizing).
  • NSTextView+Dejal: Properties for string, attributed string and RTF values, methods for length, range, appending, and selection.
  • NSToolbar+Dejal: Methods for the toolbar height and finding an item by identifier.
  • NSView+Dejal: Add a view as a fully-constrained subview, adjust autoresizing, scale, and set the alpha opacity.
  • NSViewController+Dejal: Transition a view controller to another one as a fully-constrained subview.
  • NSWindow+Dejal: Methods to force editing to end, fade in a window, and adjust the sizing of the window based on a view.

The methods use a dejal_ prefix to ensure uniqueness (important with categories).

Some of the methods date back over 10 years, so may be less useful nowadays, or have outdated code style. But there are still lots of gems that are used in all Dejal apps.

Usage

Include the desired source files in your project.

License and Warranty

This code uses the standard BSD license. See the included License.txt file. Please also see the Dejal Open Source License web page for more information.

You can use this code at no cost, with attribution. A non-attribution license is also available, for a fee.

You're welcome to use it in commercial, closed-source, open source, free or any other kind of software, as long as you credit Dejal appropriately.

The placement and format of the credit is up to you, but I prefer the credit to be in the software's "About" window or view, if any. Alternatively, you could put the credit in the software's documentation, or on the web page for the product. The suggested format for the attribution is:

Includes DejalAppKitCategories code from Dejal.

Where possible, please link the text "Dejal" to the Dejal Developer web page, or include the page's URL: http://www.dejal.com/developer/.

This code comes with no warranty of any kind. I hope it'll be useful to you, but I make no guarantees regarding its functionality or otherwise.

Support / Contact / Bugs / Features

I can't promise to answer questions about how to use the code.

If you create an app that uses the code, please tell me about it.

If you want to submit a feature request or bug report, please use GitHub's issue tracker for this project. Or preferably fork the code and implement the feature/fix yourself, then submit a pull request.

Enjoy!

David Sinclair
Dejal Systems, LLC

Contact: http://www.dejal.com/contact/?subject=DejalAppKitCategories More open source projects: http://www.dejal.com/developer Open source announcements on Twitter: http://twitter.com/dejalopen General Dejal news on Twitter: http://twitter.com/dejal