Difference between revisions of "UIColor"

From iPhone Development Wiki
Jump to: navigation, search
m (Thai.)
 
(5 intermediate revisions by 4 users not shown)
Line 1: Line 1:
 +
<small>'''Languages: English &bull; [[UIColor/fr|français]]''' &bull; '''[[UIColor/th|ไทย]]'''</small>
 +
 
[[UIColor]] is a class representing a solid color or a pattern, similar to brushes in Windows GDI.
 
[[UIColor]] is a class representing a solid color or a pattern, similar to brushes in Windows GDI.
  
 
== Predefined colors ==
 
== 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 ===
 
=== Documented solid colors ===
{| class="wikitable" style="text-align: center; width: 100%;"
+
{| class="wikitable" style="text-align: left; width: 100%;"
 
|- style="height: 50px;"
 
|- style="height: 50px;"
 
| style="background-color: black;" width="5%" |  
 
| style="background-color: black;" width="5%" |  
Line 51: Line 53:
 
=== Undocumented solid colors ===
 
=== Undocumented solid colors ===
  
{| class="wikitable" style="text-align: center; width: 100%;"
+
{| class="wikitable" style="text-align: left; width: 100%;"
 
|- style="height: 50px;"
 
|- style="height: 50px;"
 
| style="background-color: #ABABAB;" width="5%" |  
 
| style="background-color: #ABABAB;" width="5%" |  
Line 111: Line 113:
 
| style="background-color: #70a8fc;" |
 
| style="background-color: #70a8fc;" |
 
| <tt>selectionHighlightColor</tt><br />0.44, 0.66, 0.99 [18% alpha]
 
| <tt>selectionHighlightColor</tt><br />0.44, 0.66, 0.99 [18% alpha]
 +
 +
|- style="height: 50px;"
 +
| style="background-color: #058cf5;" |
 +
| <tt>tableSelectionGradientStartColor</tt><br />0.02, 0.55, 0.96
 +
| style="background-color: #0a5ee8;" |
 +
| <tt>tableSelectionGradientEndColor</tt><br />0.04, 0.37, 0.91
 
|}
 
|}
  
Line 131: Line 139:
 
|}
 
|}
  
Note: the public color {{ObjcCall|UIColor|scrollViewTexturedBackgroundColor|ClassMethod=1}} returns <tt>pinStripeColor</tt> on iPhone and <tt>clearColor</tt> on iPad.
+
Note: the public colors {{ObjcCall|UIColor|scrollViewTexturedBackgroundColor|ClassMethod=1}} and {{ObjcCall|UIColor|groupTableViewBackgroundColor|ClassMethod=1}} return <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 ==
 
== CSS colors ==
Line 140: Line 154:
  
 
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>.
 
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 ==
 
== References ==
 
* Official documentation: http://developer.apple.com/iphone/library/documentation/uikit/reference/UIColor_Class/Reference/Reference.html
 
* 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
 
* 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}}
 
{{occlass|library=UIKit.framework|navbox=on}}

Latest revision as of 04:07, 18 May 2014

Languages: English • françaisไทย

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]
tableSelectionGradientStartColor
0.02, 0.55, 0.96
tableSelectionGradientEndColor
0.04, 0.37, 0.91

Patterns

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

Note: the public colors +[UIColor scrollViewTexturedBackgroundColor] and +[UIColor groupTableViewBackgroundColor] return 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

Signature -(NSString*)styleString
Available in 2.0 –

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

References