UIColor: Difference between revisions

Revision as of 09:04, 6 February 2010

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`	UIStockImageScrollViewTexturedBackgroundColor.png

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

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 53: / Line 53: @@
 {| class="wikitable" style="text-align: center; width: 100%;"
 |- style="height: 50px;"
-| style="background-color: #A8ABAD;" width="5%" |
+| style="background-color: #ABABAB;" width="5%" |
-| width="20%" | <tt>tableSeparatorDarkColor</tt><br />0.66, 0.67, 0.68
+| width="20%" | <tt>tableSeparatorDarkColor</tt><br />0.67, 0.67, 0.67
 | style="background-color: #E0E0E0;" width="5%" |
 | width="20%" | <tt>tableSeparatorLightColor</tt><br />0.88, 0.88, 0.88
@@ Line 89: / Line 89: @@
 | style="background-color: #526691;" |
 | <tt>tableCellValue2BlueColor</tt><br />0.32, 0.40, 0.57
+| style="background-color: black;" |
+| <tt>tableGroupedSeparatorLightColor</tt><br />0.00, 0.00, 0.00 [18% alpha]
+|- style="height: 50px;"
+| style="background-color: white;" |
+| <tt>tableCellPlainBackgroundColor</tt><br />1.00, 1.00, 1.00
+| style="padding: 0;" | <table width="100%" cellspacing="0"><tr><td style="background-color: #f7f7f7; height:21px; border-width: 0;"> </td></tr><tr><td style="background-color: white; height:21px; border-width: 0;"> </td></tr></table>
+| <tt>tableCellGroupedBackgroundColor</tt><br /><span style="font-size:0.5em;">0.97, 0.97, 0.97 (iPad) / 1.00, 1.00, 1.00 (iPhone)</span>
+| style="background-color: #ffffe8;" |
+| <tt>tableShadowColor</tt><br />1.00, 1.00, 0.91
+| style="background-color: black;" |
+| <tt>tableGroupedTopShadowColor</tt><br />0.00, 0.00, 0.00 [8% alpha]
+|- style="height: 50px;"
+| style="background-color: #0054a6;" |
+| <tt>selectionTintColor</tt><br />0.00, 0.33, 0.65 [20% alpha]
+| style="padding: 0;" | <table width="100%" cellspacing="0"><tr><td style="background-color: #426bf2; height:21px; border-width: 0;"> </td></tr><tr><td style="background-color: #684f45; height:21px; border-width: 0;"> </td></tr></table>
+| <tt>textCaretColor</tt><br /><span style="font-size:0.5em;">0.26, 0.42, 0.95 / 0.41, 0.31, 0.27 (MobileNotes)</span>
+| style="background-color: #426bf2;" |
+| <tt>selectionCaretColor</tt><br />0.26, 0.42, 0.95
+| style="background-color: #70a8fc;" |
+| <tt>selectionHighlightColor</tt><br />0.44, 0.66, 0.99 [18% alpha]
 |}
@@ Line 96: / Line 117: @@
 {| class="wikitable"
 |- style="height: 52px;"
-| rowspan="3" style="padding:0px;" | [[Image:UIColorPatterns.png]]
+| rowspan="6" style="padding:0px;" | [[Image:UIColorPatterns.png]]
-| <tt>groupTableViewBackgroundColor</tt>
+| <tt>pinStripeColor</tt> || UIPinStripe.png
 |- style="height: 51px;"
-| <tt>viewFlipsideBackgroundColor</tt>
+| <tt>viewFlipsideBackgroundColor</tt><br />(Public) || UIStockImageWidgetBacksideBackground.png
 |- style="height: 51px;"
-| <tt>underPageBackgroundColor</tt><br />(Private)
+| <tt>underPageBackgroundColor</tt> || UIStockImageUnderPageBackground.png
+|- style="height: 51px;"
+| <tt>noContentLightGradientBackgroundColor</tt> || UIStockImageNoContentLightGradientBackgroundColor.png
+|- style="height: 51px;"
+| <tt>noContentDarkGradientBackgroundColor</tt> || UIStockImageNoContentDarkGradientBackgroundColor.png
+|- style="height: 51px;"
+| <tt>scrollViewTexturedBackgroundColor</tt> || UIStockImageScrollViewTexturedBackgroundColor.png
 |}
+Note: the public color {{ObjcCall|UIColor|scrollViewTexturedBackgroundColor|ClassMethod=1}} returns <tt>pinStripeColor</tt> on iPhone and <tt>clearColor</tt> on iPad.
 == CSS colors ==