UIColor: Difference between revisions

Revision as of 22:34, 21 January 2011

UIColor is a class representing a solid color or a pattern, similar to brushes in Windows GDI.

Predefined colors

UIColor defines a list of commonly accessed colors. They can be received using +[UIColor someColor], as listed below:

Documented solid colors

`blackColor` 0.000	`darkGrayColor` 0.333	`lightGrayColor` 0.667	`whiteColor` 1.000	`grayColor` 0.500
`redColor` 1.00, 0.00, 0.00	`greenColor` 0.00, 1.00, 0.00	`blueColor` 0.00, 0.00, 1.00	`cyanColor` 0.00, 1.00, 1.00	`yellowColor` 1.00, 1.00, 0.00
`magentaColor` 1.00, 0.00, 1.00	`orangeColor` 1.00, 0.50, 0.00	`purpleColor` 0.50, 0.00, 0.50	`brownColor` 0.60, 0.40, 0.20	`clearColor` 0.000 [0% alpha]
`lightTextColor` 1.000 [60% alpha]	`darkTextColor` 0.000

Undocumented solid colors

tableSeparatorDarkColor
0.67, 0.67, 0.67 tableSeparatorLightColor
0.88, 0.88, 0.88 tableBackgroundColor
1.00, 1.00, 1.00 tableSelectionColor
0.16, 0.43, 0.83

sectionListBorderColor
0.52, 0.56, 0.58 [60% alpha] sectionHeaderBackgroundColor
0.90, 0.93, 0.99 [80% alpha] sectionHeaderOpaqueBackgroundColor
0.92, 0.94, 0.99 sectionHeaderBorderColor
0.85, 0.87, 0.91

tableCellBlueTextColor
0.22, 0.33, 0.53 tableCellGrayTextColor
0.50, 0.50, 0.50 textFieldAtomBlueColor
0.16, 0.34, 1.00 textFieldAtomPurpleColor
0.41, 0.00, 0.74

infoTextOverPinStripeTextColor
0.30, 0.34, 0.42 tableCellValue1BlueColor
0.22, 0.33, 0.53 tableCellValue2BlueColor
0.32, 0.40, 0.57 tableGroupedSeparatorLightColor
0.00, 0.00, 0.00 [18% alpha]

tableCellPlainBackgroundColor
1.00, 1.00, 1.00

tableCellGroupedBackgroundColor
0.97, 0.97, 0.97 (iPad) / 1.00, 1.00, 1.00 (iPhone)

tableShadowColor
1.00, 1.00, 0.91

tableGroupedTopShadowColor
0.00, 0.00, 0.00 [8% alpha]

selectionTintColor
0.00, 0.33, 0.65 [20% alpha]

textCaretColor
0.26, 0.42, 0.95 / 0.41, 0.31, 0.27 (MobileNotes)

selectionCaretColor
0.26, 0.42, 0.95

selectionHighlightColor
0.44, 0.66, 0.99 [18% alpha]

Patterns

	`pinStripeColor`	UIPinStripe.png
	`viewFlipsideBackgroundColor` (Public)	UIStockImageWidgetBacksideBackground.png
	`underPageBackgroundColor`	UIStockImageUnderPageBackground.png
	`noContentLightGradientBackgroundColor`	UIStockImageNoContentLightGradientBackgroundColor.png
	`noContentDarkGradientBackgroundColor`	UIStockImageNoContentDarkGradientBackgroundColor.png
	`scrollViewTexturedBackgroundColor` (Public)	UIStockImageScrollViewTexturedBackgroundColor.png

Note: the public color +[UIColor scrollViewTexturedBackgroundColor] returns pinStripeColor on iPhone and clearColor on iPad.

Custom Patterns

If the default textures or colors don't suit, and you don't want a solid color, an image file can be loaded to behave similar to the Patterns above via +[UIColor colorWithPatternImage:].

If an image is too small to fit, the OS will tile the image over the screen, and this technique can be used to make backgrounds from small image files. If a image is too large, it continues off the screen.

CSS colors

Available in	2.0 –
Signature	`-(NSString*)styleString`

UIColors can be converted to CSS colors by the -styleString method. For example, [[UIColor lightTextColor] styleString] gives @"rgba(255,255,255,153)".

References

Official documentation: http://developer.apple.com/iphone/library/documentation/uikit/reference/UIColor_Class/Reference/Reference.html
Extra header: http://github.com/kennytm/iphone-private-frameworks/blob/master/UIKit/UIColor2.h

@@ Line 2: / Line 2: @@
 == Predefined colors ==
-UIColor defines a list of commonly accessed colors. They can be received using <tt>+[UIColor </tt>''someColor''<tt>]</tt>, as listed below:
+UIColor defines a list of commonly accessed colors. They can be received using {{ObjcCall|UIColor|''someColor''|ClassMethod=1}}, as listed below:
 === Documented solid colors ===
@@ Line 132: / Line 132: @@
 Note: the public color {{ObjcCall|UIColor|scrollViewTexturedBackgroundColor|ClassMethod=1}} returns <tt>pinStripeColor</tt> on iPhone and <tt>clearColor</tt> on iPad.
+==== Custom Patterns ====
+If the default textures or colors don't suit, and you don't want a solid color, an image file can be loaded to behave similar to the Patterns above via {{ObjcCall|UIColor|colorWithPatternImage:|ClassMethod=1}}.
+If an image is too small to fit, the OS will tile the image over the screen, and this technique can be used to make backgrounds from small image files. If a image is too large, it continues off the screen.
 == CSS colors ==
@@ Line 140: / Line 146: @@
 UIColors can be converted to CSS colors by the <tt>-styleString</tt> method. For example, <tt>[[UIColor lightTextColor] styleString]</tt> gives <tt>@"rgba(255,255,255,153)"</tt>.
-== Using a image file with UIColor ==
-If the default textures or colors don't suit, and you don't want a solid colour an image file can be loaded to behave similar to the Patterns above.
-This can be achieved using the following code
-<tt>[UIColor colorWithPatternImage:[UIImage imageWithContentsOfFile:[[[NSBundle mainBundle] resourcePath] stringByAppendingPathComponent:@"picture.png"]]]; </tt>
-If an image is too small to fit, the OS will tile the image over the screen, and this technique can be used to make backgrounds from small image files. If a image is too large, it continues off the screen.
 == References ==
 * Official documentation: http://developer.apple.com/iphone/library/documentation/uikit/reference/UIColor_Class/Reference/Reference.html
 * Extra header: http://github.com/kennytm/iphone-private-frameworks/blob/master/UIKit/UIColor2.h
-* UIColour with Image code: Scott Rapson from somewhere in here http://www.26oclock.com/blog
 {{occlass|library=UIKit.framework|navbox=on}}