1
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
2
<html xmlns="http://www.w3.org/1999/xhtml">
4
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
5
<title>gtkmm: Gdk::GC Class Reference</title>
6
<link href="tabs.css" rel="stylesheet" type="text/css"/>
7
<link href="doxygen.css" rel="stylesheet" type="text/css"/>
10
<!-- Generated by Doxygen 1.7.3 -->
13
<table cellspacing="0" cellpadding="0">
15
<tr style="height: 56px;">
16
<td style="padding-left: 0.5em;">
17
<div id="projectname">gtkmm <span id="projectnumber">2.24.2</span></div>
23
<div id="navrow1" class="tabs">
25
<li><a href="index.html"><span>Main Page</span></a></li>
26
<li><a href="pages.html"><span>Related Pages</span></a></li>
27
<li><a href="modules.html"><span>Modules</span></a></li>
28
<li><a href="namespaces.html"><span>Namespaces</span></a></li>
29
<li class="current"><a href="annotated.html"><span>Classes</span></a></li>
32
<div id="navrow2" class="tabs2">
34
<li><a href="annotated.html"><span>Class List</span></a></li>
35
<li><a href="classes.html"><span>Class Index</span></a></li>
36
<li><a href="inherits.html"><span>Class Hierarchy</span></a></li>
37
<li><a href="functions.html"><span>Class Members</span></a></li>
40
<div id="nav-path" class="navpath">
42
<li class="navelem"><a class="el" href="namespaceGdk.html">Gdk</a> </li>
43
<li class="navelem"><a class="el" href="classGdk_1_1GC.html">GC</a> </li>
49
<a href="#pub-methods">Public Member Functions</a> |
50
<a href="#pub-static-methods">Static Public Member Functions</a> |
51
<a href="#pro-methods">Protected Member Functions</a> |
52
<a href="#related">Related Functions</a> </div>
53
<div class="headertitle">
54
<h1>Gdk::GC Class Reference</h1> </div>
56
<div class="contents">
57
<!-- doxytag: class="Gdk::GC" --><!-- doxytag: inherits="Glib::Object" -->
58
<p>All drawing operations in GDK take a graphics context (<a class="el" href="classGdk_1_1GC.html" title="All drawing operations in GDK take a graphics context (GC) argument.">GC</a>) argument. <a href="#_details">More...</a></p>
59
<div class="dynheader">
60
Inheritance diagram for Gdk::GC:</div>
61
<div class="dyncontent">
62
<div class="center"><img src="classGdk_1_1GC__inherit__graph.png" border="0" usemap="#Gdk_1_1GC_inherit__map" alt="Inheritance graph"/></div>
63
<map name="Gdk_1_1GC_inherit__map" id="Gdk_1_1GC_inherit__map">
64
<area shape="rect" id="node2" href="../../../glibmm-2.4/reference/html/classGlib_1_1Object.html" title="Glib::Object" alt="" coords="20,166,111,197"/><area shape="rect" id="node4" href="../../../glibmm-2.4/reference/html/classGlib_1_1ObjectBase.html" title="Glib::ObjectBase" alt="" coords="5,86,125,117"/><area shape="rect" id="node6" href="../../../libsigc++-2.0/reference/html/structsigc_1_1trackable.html" title="sigc::trackable" alt="" coords="12,6,119,37"/></map>
65
<center><span class="legend">[<a href="graph_legend.html">legend</a>]</span></center></div>
66
<div class="dynheader">
67
Collaboration diagram for Gdk::GC:</div>
68
<div class="dyncontent">
69
<div class="center"><img src="classGdk_1_1GC__coll__graph.png" border="0" usemap="#Gdk_1_1GC_coll__map" alt="Collaboration graph"/></div>
70
<map name="Gdk_1_1GC_coll__map" id="Gdk_1_1GC_coll__map">
71
<area shape="rect" id="node2" href="../../../glibmm-2.4/reference/html/classGlib_1_1Object.html" title="Glib::Object" alt="" coords="20,166,111,197"/><area shape="rect" id="node4" href="../../../glibmm-2.4/reference/html/classGlib_1_1ObjectBase.html" title="Glib::ObjectBase" alt="" coords="5,86,125,117"/><area shape="rect" id="node6" href="../../../libsigc++-2.0/reference/html/structsigc_1_1trackable.html" title="sigc::trackable" alt="" coords="12,6,119,37"/></map>
72
<center><span class="legend">[<a href="graph_legend.html">legend</a>]</span></center></div>
74
<p><a href="classGdk_1_1GC-members.html">List of all members.</a></p>
75
<table class="memberdecls">
76
<tr><td colspan="2"><h2><a name="pub-methods"></a>
77
Public Member Functions</h2></td></tr>
78
<tr><td class="memItemLeft" align="right" valign="top">virtual </td><td class="memItemRight" valign="bottom"><a class="el" href="classGdk_1_1GC.html#a56dbf2a31cef26e837eccbf2dbb2e1f2">~GC</a> ()</td></tr>
79
<tr><td class="memItemLeft" align="right" valign="top">GdkGC* </td><td class="memItemRight" valign="bottom"><a class="el" href="classGdk_1_1GC.html#a8093f885d5735177424a426156b79f3a">gobj</a> ()</td></tr>
80
<tr><td class="mdescLeft"> </td><td class="mdescRight">Provides access to the underlying C GObject. <a href="#a8093f885d5735177424a426156b79f3a"></a><br/></td></tr>
81
<tr><td class="memItemLeft" align="right" valign="top">const GdkGC* </td><td class="memItemRight" valign="bottom"><a class="el" href="classGdk_1_1GC.html#a390461c9f64f1df71b760325e45790b8">gobj</a> () const </td></tr>
82
<tr><td class="mdescLeft"> </td><td class="mdescRight">Provides access to the underlying C GObject. <a href="#a390461c9f64f1df71b760325e45790b8"></a><br/></td></tr>
83
<tr><td class="memItemLeft" align="right" valign="top">GdkGC* </td><td class="memItemRight" valign="bottom"><a class="el" href="classGdk_1_1GC.html#a55936486f1a0b55cfa08eb46bb27630e">gobj_copy</a> ()</td></tr>
84
<tr><td class="mdescLeft"> </td><td class="mdescRight">Provides access to the underlying C instance. The caller is responsible for unrefing it. Use when directly setting fields in structs. <a href="#a55936486f1a0b55cfa08eb46bb27630e"></a><br/></td></tr>
85
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classGdk_1_1GC.html#ae16759ef3ee9b3696021369f61d62fea">set_foreground</a> (const <a class="el" href="classGdk_1_1Color.html">Color</a>& color)</td></tr>
86
<tr><td class="mdescLeft"> </td><td class="mdescRight">Sets the foreground color for a graphics context. <a href="#ae16759ef3ee9b3696021369f61d62fea"></a><br/></td></tr>
87
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classGdk_1_1GC.html#ada203718d98a1305eb8c93d5cd2b2356">set_background</a> (const <a class="el" href="classGdk_1_1Color.html">Color</a>& color)</td></tr>
88
<tr><td class="mdescLeft"> </td><td class="mdescRight">Sets the background color for a graphics context. <a href="#ada203718d98a1305eb8c93d5cd2b2356"></a><br/></td></tr>
89
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classGdk_1_1GC.html#ade0340da1088f4ecdde89e9180212e0b">set_function</a> (<a class="el" href="group__gdkmmEnums.html#gaf1365a8c559e749927e68d3ae723a47b">Function</a> function)</td></tr>
90
<tr><td class="mdescLeft"> </td><td class="mdescRight">Determines how the current pixel values and the pixel values being drawn are combined to produce the final pixel values. <a href="#ade0340da1088f4ecdde89e9180212e0b"></a><br/></td></tr>
91
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classGdk_1_1GC.html#ae95140c1494e4450ca22fccded72337c">set_fill</a> (<a class="el" href="group__gdkmmEnums.html#gaf945088bf264cc01bf858c3468d2a451">Fill</a> <a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01570.html#gae3f9c9c748ac8e4b124a39bfd7adec40">fill</a>)</td></tr>
92
<tr><td class="mdescLeft"> </td><td class="mdescRight">Set the fill mode for a graphics context. <a href="#ae95140c1494e4450ca22fccded72337c"></a><br/></td></tr>
93
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classGdk_1_1GC.html#aae51d032ddbea405bb177268cab521cc">set_tile</a> (const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a>< <a class="el" href="classGdk_1_1Pixmap.html">Pixmap</a> >& tile)</td></tr>
94
<tr><td class="mdescLeft"> </td><td class="mdescRight">Set a tile pixmap for a graphics context. <a href="#aae51d032ddbea405bb177268cab521cc"></a><br/></td></tr>
95
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classGdk_1_1GC.html#af6c8c1f159ab300994417aa6d1a2ff4a">set_stipple</a> (const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a>< <a class="el" href="classGdk_1_1Pixmap.html">Pixmap</a> >& stipple)</td></tr>
96
<tr><td class="mdescLeft"> </td><td class="mdescRight">Set the stipple bitmap for a graphics context. <a href="#af6c8c1f159ab300994417aa6d1a2ff4a"></a><br/></td></tr>
97
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classGdk_1_1GC.html#a86994e1325f39ae18278cbd6c298bcac">set_ts_origin</a> (int x, int y)</td></tr>
98
<tr><td class="mdescLeft"> </td><td class="mdescRight">Set the origin when using tiles or stipples with the <a class="el" href="classGdk_1_1GC.html" title="All drawing operations in GDK take a graphics context (GC) argument.">GC</a>. <a href="#a86994e1325f39ae18278cbd6c298bcac"></a><br/></td></tr>
99
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classGdk_1_1GC.html#afa0f2fc8b4c78db4feed66b5806db1bf">set_clip_origin</a> (int x, int y)</td></tr>
100
<tr><td class="mdescLeft"> </td><td class="mdescRight">Sets the origin of the clip mask. <a href="#afa0f2fc8b4c78db4feed66b5806db1bf"></a><br/></td></tr>
101
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classGdk_1_1GC.html#acc35c552632d7eb9a46d02de6be952f8">set_clip_mask</a> (const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a>< <a class="el" href="classGdk_1_1Bitmap.html">Bitmap</a> >& mask)</td></tr>
102
<tr><td class="mdescLeft"> </td><td class="mdescRight">Sets the clip mask for a graphics context from a bitmap. <a href="#acc35c552632d7eb9a46d02de6be952f8"></a><br/></td></tr>
103
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classGdk_1_1GC.html#a9f83feb6a71dcea826f80f65f778eff8">set_clip_rectangle</a> (<a class="el" href="classGdk_1_1Rectangle.html">Rectangle</a>& rectangle)</td></tr>
104
<tr><td class="mdescLeft"> </td><td class="mdescRight">Sets the clip mask for a graphics context from a rectangle. <a href="#a9f83feb6a71dcea826f80f65f778eff8"></a><br/></td></tr>
105
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classGdk_1_1GC.html#a8df6e778b7312f3f198842aea3f7bb43">set_clip_rectangle</a> (const <a class="el" href="classGdk_1_1Rectangle.html">Rectangle</a>& rectangle)</td></tr>
106
<tr><td class="mdescLeft"> </td><td class="mdescRight">Sets the clip mask for a graphics context from a rectangle. <a href="#a8df6e778b7312f3f198842aea3f7bb43"></a><br/></td></tr>
107
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classGdk_1_1GC.html#a6109789b4e63e62443fa9433c77525e8">set_clip_region</a> (const <a class="el" href="classGdk_1_1Region.html">Region</a>& region)</td></tr>
108
<tr><td class="mdescLeft"> </td><td class="mdescRight">Sets the clip mask for a graphics context from a region structure. <a href="#a6109789b4e63e62443fa9433c77525e8"></a><br/></td></tr>
109
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classGdk_1_1GC.html#a2d1af56f1e93a7bc88340495e2cb3ffc">set_subwindow</a> (<a class="el" href="group__gdkmmEnums.html#gaae37637a79c9ee9822c925f30748eafd">SubwindowMode</a> mode)</td></tr>
110
<tr><td class="mdescLeft"> </td><td class="mdescRight">Sets how drawing with this <a class="el" href="classGdk_1_1GC.html" title="All drawing operations in GDK take a graphics context (GC) argument.">GC</a> on a window will affect child windows of that window. <a href="#a2d1af56f1e93a7bc88340495e2cb3ffc"></a><br/></td></tr>
111
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classGdk_1_1GC.html#a8d45034c577e55fd350a8556a3c242ff">set_exposures</a> (bool exposures)</td></tr>
112
<tr><td class="mdescLeft"> </td><td class="mdescRight">Sets whether copying non-visible portions of a drawable using this graphics context generate exposure events for the corresponding regions of the destination drawable. <a href="#a8d45034c577e55fd350a8556a3c242ff"></a><br/></td></tr>
113
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classGdk_1_1GC.html#a6ffd36fdf941a6ee478c15b2d1ec0a10">set_line_attributes</a> (int line_width, <a class="el" href="group__gdkmmEnums.html#gac5dcb29dfe744e4e8b72693b392ac06e">LineStyle</a> line_style, <a class="el" href="group__gdkmmEnums.html#ga8cb10204a21a8576e6977249380ae9a6">CapStyle</a> cap_style, <a class="el" href="group__gdkmmEnums.html#ga91500dd25e90700bb632791263c7d9ec">JoinStyle</a> join_style)</td></tr>
114
<tr><td class="mdescLeft"> </td><td class="mdescRight">Sets various attributes of how lines are drawn. <a href="#a6ffd36fdf941a6ee478c15b2d1ec0a10"></a><br/></td></tr>
115
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classGdk_1_1GC.html#aae81765dc15ad450d56f69219d73ffad">set_dashes</a> (int dash_offset, gint8* dash_list, int n)</td></tr>
116
<tr><td class="mdescLeft"> </td><td class="mdescRight">Sets the way dashed-lines are drawn. <a href="#aae81765dc15ad450d56f69219d73ffad"></a><br/></td></tr>
117
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classGdk_1_1GC.html#a212a2bba5970500d0c6a1a9809b734b4">offset</a> (int x_offset, int y_offset)</td></tr>
118
<tr><td class="mdescLeft"> </td><td class="mdescRight">Offset attributes such as the clip and tile-stipple origins of the <a class="el" href="classGdk_1_1GC.html" title="All drawing operations in GDK take a graphics context (GC) argument.">GC</a> so that drawing at x - x_offset, y - y_offset with the offset <a class="el" href="classGdk_1_1GC.html" title="All drawing operations in GDK take a graphics context (GC) argument.">GC</a> has the same effect as drawing at x, y with the original <a class="el" href="classGdk_1_1GC.html" title="All drawing operations in GDK take a graphics context (GC) argument.">GC</a>. <a href="#a212a2bba5970500d0c6a1a9809b734b4"></a><br/></td></tr>
119
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classGdk_1_1GC.html#a123478ef0e9046f8ac1d0e1179ef4e04">set_colormap</a> (const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a>< <a class="el" href="classGdk_1_1Colormap.html">Colormap</a> >& colormap)</td></tr>
120
<tr><td class="mdescLeft"> </td><td class="mdescRight">Sets the colormap for the <a class="el" href="classGdk_1_1GC.html" title="All drawing operations in GDK take a graphics context (GC) argument.">GC</a> to the given colormap. <a href="#a123478ef0e9046f8ac1d0e1179ef4e04"></a><br/></td></tr>
121
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a>< <a class="el" href="classGdk_1_1Colormap.html">Colormap</a> > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGdk_1_1GC.html#aa2bed53c761acf6c8bcb80902961b303">get_colormap</a> ()</td></tr>
122
<tr><td class="mdescLeft"> </td><td class="mdescRight">Retrieves the colormap for a given <a class="el" href="classGdk_1_1GC.html" title="All drawing operations in GDK take a graphics context (GC) argument.">GC</a>, if it exists. <a href="#aa2bed53c761acf6c8bcb80902961b303"></a><br/></td></tr>
123
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classGdk_1_1GC.html#afeebd8928915e5836ed5a2c0d13dcd09">set_rgb_fg_color</a> (const <a class="el" href="classGdk_1_1Color.html">Color</a>& color)</td></tr>
124
<tr><td class="mdescLeft"> </td><td class="mdescRight">Set the foreground color of a <a class="el" href="classGdk_1_1GC.html" title="All drawing operations in GDK take a graphics context (GC) argument.">GC</a> using an unallocated color. <a href="#afeebd8928915e5836ed5a2c0d13dcd09"></a><br/></td></tr>
125
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classGdk_1_1GC.html#acd78b85d14212d71a1af38b8b1524c5d">set_rgb_bg_color</a> (const <a class="el" href="classGdk_1_1Color.html">Color</a>& color)</td></tr>
126
<tr><td class="mdescLeft"> </td><td class="mdescRight">Set the background color of a <a class="el" href="classGdk_1_1GC.html" title="All drawing operations in GDK take a graphics context (GC) argument.">GC</a> using an unallocated color. <a href="#acd78b85d14212d71a1af38b8b1524c5d"></a><br/></td></tr>
127
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a>< <a class="el" href="classGdk_1_1Screen.html">Screen</a> > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGdk_1_1GC.html#a4f95a093fbc1c0f6c6da4e5d07aa35f4">get_screen</a> ()</td></tr>
128
<tr><td class="mdescLeft"> </td><td class="mdescRight">Gets the <a class="el" href="classGdk_1_1Screen.html" title="Object representing a physical screen Gdk::Screen objects are the GDK representation of a physical sc...">Gdk::Screen</a> for which <em>gc</em> was created. <a href="#a4f95a093fbc1c0f6c6da4e5d07aa35f4"></a><br/></td></tr>
129
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a>< const <a class="el" href="classGdk_1_1Screen.html">Screen</a> > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGdk_1_1GC.html#a95a7373f5631650dda36ea5854ffc631">get_screen</a> () const </td></tr>
130
<tr><td class="mdescLeft"> </td><td class="mdescRight">Gets the <a class="el" href="classGdk_1_1Screen.html" title="Object representing a physical screen Gdk::Screen objects are the GDK representation of a physical sc...">Gdk::Screen</a> for which <em>gc</em> was created. <a href="#a95a7373f5631650dda36ea5854ffc631"></a><br/></td></tr>
131
<tr><td colspan="2"><h2><a name="pub-static-methods"></a>
132
Static Public Member Functions</h2></td></tr>
133
<tr><td class="memItemLeft" align="right" valign="top">static <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a>< <a class="el" href="classGdk_1_1GC.html">GC</a> > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGdk_1_1GC.html#a64493d4701c3879afee14c44d7f55c60">create</a> ()</td></tr>
134
<tr><td class="memItemLeft" align="right" valign="top">static <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a>< <a class="el" href="classGdk_1_1GC.html">GC</a> > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGdk_1_1GC.html#a9a9c71d678b9a34bebc851ddf71b1c57">create</a> (const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a>< <a class="el" href="classGdk_1_1Drawable.html">Drawable</a> >& drawable)</td></tr>
135
<tr><td colspan="2"><h2><a name="pro-methods"></a>
136
Protected Member Functions</h2></td></tr>
137
<tr><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="classGdk_1_1GC.html#ae6cfa690ab8371f66aad8ba8cda66042">GC</a> ()</td></tr>
138
<tr><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="classGdk_1_1GC.html#a0f6b3b842762fc7ff949cb3cfe8a21ad">GC</a> (const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a>< <a class="el" href="classGdk_1_1Drawable.html">Drawable</a> >& drawable)</td></tr>
139
<tr><td colspan="2"><h2><a name="related"></a>
140
Related Functions</h2></td></tr>
141
<tr><td colspan="2">(Note that these are not member functions.) <br/></td></tr>
142
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a>< <a class="el" href="classGdk_1_1GC.html">Gdk::GC</a> > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGdk_1_1GC.html#a3f214c3e4eba764b69121a337c862bc1">wrap</a> (GdkGC* object, bool take_copy=false)</td></tr>
143
<tr><td class="mdescLeft"> </td><td class="mdescRight">A <a class="elRef" href="../../../glibmm-2.4/reference/html/namespaceGlib.html#a671306f4a3a0cae5ab4d7a9d54886592">Glib::wrap()</a> method for this object. <a href="#a3f214c3e4eba764b69121a337c862bc1"></a><br/></td></tr>
145
<hr/><a name="_details"></a><h2>Detailed Description</h2>
146
<div class="textblock"><p>All drawing operations in GDK take a graphics context (<a class="el" href="classGdk_1_1GC.html" title="All drawing operations in GDK take a graphics context (GC) argument.">GC</a>) argument. </p>
147
<p>A graphics context encapsulates information about the way things are drawn, such as the foreground color or line width. By using graphics contexts, the number of arguments to each drawing call is greatly reduced, and communication overhead is minimized, since identical arguments do not need to be passed repeatedly. </p>
148
</div><hr/><h2>Constructor & Destructor Documentation</h2>
149
<a class="anchor" id="a56dbf2a31cef26e837eccbf2dbb2e1f2"></a><!-- doxytag: member="Gdk::GC::~GC" ref="a56dbf2a31cef26e837eccbf2dbb2e1f2" args="()" -->
150
<div class="memitem">
151
<div class="memproto">
152
<table class="memname">
154
<td class="memname">virtual Gdk::GC::~GC </td>
156
<td class="paramname"></td><td>)</td>
157
<td><code> [virtual]</code></td>
165
<a class="anchor" id="ae6cfa690ab8371f66aad8ba8cda66042"></a><!-- doxytag: member="Gdk::GC::GC" ref="ae6cfa690ab8371f66aad8ba8cda66042" args="()" -->
166
<div class="memitem">
167
<div class="memproto">
168
<table class="memname">
170
<td class="memname">Gdk::GC::GC </td>
172
<td class="paramname"></td><td>)</td>
173
<td><code> [protected]</code></td>
181
<a class="anchor" id="a0f6b3b842762fc7ff949cb3cfe8a21ad"></a><!-- doxytag: member="Gdk::GC::GC" ref="a0f6b3b842762fc7ff949cb3cfe8a21ad" args="(const Glib::RefPtr< Drawable > &drawable)" -->
182
<div class="memitem">
183
<div class="memproto">
184
<table class="memname">
186
<td class="memname">Gdk::GC::GC </td>
188
<td class="paramtype">const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a>< <a class="el" href="classGdk_1_1Drawable.html">Drawable</a> >& </td>
189
<td class="paramname"><em>drawable</em></td><td>)</td>
190
<td><code> [explicit, protected]</code></td>
198
<hr/><h2>Member Function Documentation</h2>
199
<a class="anchor" id="a64493d4701c3879afee14c44d7f55c60"></a><!-- doxytag: member="Gdk::GC::create" ref="a64493d4701c3879afee14c44d7f55c60" args="()" -->
200
<div class="memitem">
201
<div class="memproto">
202
<table class="memname">
204
<td class="memname">static <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a><<a class="el" href="classGdk_1_1GC.html">GC</a>> Gdk::GC::create </td>
206
<td class="paramname"></td><td>)</td>
207
<td><code> [static]</code></td>
215
<a class="anchor" id="a9a9c71d678b9a34bebc851ddf71b1c57"></a><!-- doxytag: member="Gdk::GC::create" ref="a9a9c71d678b9a34bebc851ddf71b1c57" args="(const Glib::RefPtr< Drawable > &drawable)" -->
216
<div class="memitem">
217
<div class="memproto">
218
<table class="memname">
220
<td class="memname">static <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a><<a class="el" href="classGdk_1_1GC.html">GC</a>> Gdk::GC::create </td>
222
<td class="paramtype">const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a>< <a class="el" href="classGdk_1_1Drawable.html">Drawable</a> >& </td>
223
<td class="paramname"><em>drawable</em></td><td>)</td>
224
<td><code> [static]</code></td>
232
<a class="anchor" id="aa2bed53c761acf6c8bcb80902961b303"></a><!-- doxytag: member="Gdk::GC::get_colormap" ref="aa2bed53c761acf6c8bcb80902961b303" args="()" -->
233
<div class="memitem">
234
<div class="memproto">
235
<table class="memname">
237
<td class="memname"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a><<a class="el" href="classGdk_1_1Colormap.html">Colormap</a>> Gdk::GC::get_colormap </td>
239
<td class="paramname"></td><td>)</td>
246
<p>Retrieves the colormap for a given <a class="el" href="classGdk_1_1GC.html" title="All drawing operations in GDK take a graphics context (GC) argument.">GC</a>, if it exists. </p>
247
<p>A <a class="el" href="classGdk_1_1GC.html" title="All drawing operations in GDK take a graphics context (GC) argument.">GC</a> will have a colormap if the drawable for which it was created has a colormap, or if a colormap was set explicitely with gdk_gc_set_colormap.</p>
248
<p>Deprecated: 2.22: There is no replacement. <a class="el" href="namespaceGdk_1_1Cairo.html">Cairo</a> handles colormaps automatically, so there is no need to care about them. </p>
249
<dl class="return"><dt><b>Returns:</b></dt><dd>The colormap of <em>gc</em>, or <code>0</code> if <em>gc</em> doesn't have one. </dd></dl>
253
<a class="anchor" id="a4f95a093fbc1c0f6c6da4e5d07aa35f4"></a><!-- doxytag: member="Gdk::GC::get_screen" ref="a4f95a093fbc1c0f6c6da4e5d07aa35f4" args="()" -->
254
<div class="memitem">
255
<div class="memproto">
256
<table class="memname">
258
<td class="memname"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a><<a class="el" href="classGdk_1_1Screen.html">Screen</a>> Gdk::GC::get_screen </td>
260
<td class="paramname"></td><td>)</td>
267
<p>Gets the <a class="el" href="classGdk_1_1Screen.html" title="Object representing a physical screen Gdk::Screen objects are the GDK representation of a physical sc...">Gdk::Screen</a> for which <em>gc</em> was created. </p>
268
<dl class="since_2_2"><dt><b><a class="el" href="since_2_2.html#_since_2_2000054">Since gtkmm 2.2:</a></b></dt><dd></dd></dl>
269
<dl class="return"><dt><b>Returns:</b></dt><dd>The <a class="el" href="classGdk_1_1Screen.html" title="Object representing a physical screen Gdk::Screen objects are the GDK representation of a physical sc...">Gdk::Screen</a> for <em>gc</em>. </dd></dl>
273
<a class="anchor" id="a95a7373f5631650dda36ea5854ffc631"></a><!-- doxytag: member="Gdk::GC::get_screen" ref="a95a7373f5631650dda36ea5854ffc631" args="() const " -->
274
<div class="memitem">
275
<div class="memproto">
276
<table class="memname">
278
<td class="memname"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a><const <a class="el" href="classGdk_1_1Screen.html">Screen</a>> Gdk::GC::get_screen </td>
280
<td class="paramname"></td><td>)</td>
287
<p>Gets the <a class="el" href="classGdk_1_1Screen.html" title="Object representing a physical screen Gdk::Screen objects are the GDK representation of a physical sc...">Gdk::Screen</a> for which <em>gc</em> was created. </p>
288
<dl class="since_2_2"><dt><b><a class="el" href="since_2_2.html#_since_2_2000055">Since gtkmm 2.2:</a></b></dt><dd></dd></dl>
289
<dl class="return"><dt><b>Returns:</b></dt><dd>The <a class="el" href="classGdk_1_1Screen.html" title="Object representing a physical screen Gdk::Screen objects are the GDK representation of a physical sc...">Gdk::Screen</a> for <em>gc</em>. </dd></dl>
293
<a class="anchor" id="a390461c9f64f1df71b760325e45790b8"></a><!-- doxytag: member="Gdk::GC::gobj" ref="a390461c9f64f1df71b760325e45790b8" args="() const " -->
294
<div class="memitem">
295
<div class="memproto">
296
<table class="memname">
298
<td class="memname">const GdkGC* Gdk::GC::gobj </td>
300
<td class="paramname"></td><td>)</td>
301
<td> const<code> [inline]</code></td>
307
<p>Provides access to the underlying C GObject. </p>
309
<p>Reimplemented from <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ObjectBase.html#a778a94181132976bbfb0519793f3b32e">Glib::ObjectBase</a>.</p>
313
<a class="anchor" id="a8093f885d5735177424a426156b79f3a"></a><!-- doxytag: member="Gdk::GC::gobj" ref="a8093f885d5735177424a426156b79f3a" args="()" -->
314
<div class="memitem">
315
<div class="memproto">
316
<table class="memname">
318
<td class="memname">GdkGC* Gdk::GC::gobj </td>
320
<td class="paramname"></td><td>)</td>
321
<td><code> [inline]</code></td>
327
<p>Provides access to the underlying C GObject. </p>
329
<p>Reimplemented from <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ObjectBase.html#a4c6efc18be8cb9c56e58fc0bd20fafbe">Glib::ObjectBase</a>.</p>
333
<a class="anchor" id="a55936486f1a0b55cfa08eb46bb27630e"></a><!-- doxytag: member="Gdk::GC::gobj_copy" ref="a55936486f1a0b55cfa08eb46bb27630e" args="()" -->
334
<div class="memitem">
335
<div class="memproto">
336
<table class="memname">
338
<td class="memname">GdkGC* Gdk::GC::gobj_copy </td>
340
<td class="paramname"></td><td>)</td>
347
<p>Provides access to the underlying C instance. The caller is responsible for unrefing it. Use when directly setting fields in structs. </p>
351
<a class="anchor" id="a212a2bba5970500d0c6a1a9809b734b4"></a><!-- doxytag: member="Gdk::GC::offset" ref="a212a2bba5970500d0c6a1a9809b734b4" args="(int x_offset, int y_offset)" -->
352
<div class="memitem">
353
<div class="memproto">
354
<table class="memname">
356
<td class="memname">void Gdk::GC::offset </td>
358
<td class="paramtype">int </td>
359
<td class="paramname"><em>x_offset</em>, </td>
362
<td class="paramkey"></td>
364
<td class="paramtype">int </td>
365
<td class="paramname"><em>y_offset</em> </td>
376
<p>Offset attributes such as the clip and tile-stipple origins of the <a class="el" href="classGdk_1_1GC.html" title="All drawing operations in GDK take a graphics context (GC) argument.">GC</a> so that drawing at x - x_offset, y - y_offset with the offset <a class="el" href="classGdk_1_1GC.html" title="All drawing operations in GDK take a graphics context (GC) argument.">GC</a> has the same effect as drawing at x, y with the original <a class="el" href="classGdk_1_1GC.html" title="All drawing operations in GDK take a graphics context (GC) argument.">GC</a>. </p>
377
<p>Deprecated: 2.22: There is no direct replacement, as this is just a convenience function for gdk_gc_set_ts_origin and <a class="el" href="classGdk_1_1GC.html#afa0f2fc8b4c78db4feed66b5806db1bf" title="Sets the origin of the clip mask.">set_clip_origin()</a>. </p>
378
<dl><dt><b>Parameters:</b></dt><dd>
379
<table class="params">
380
<tr><td class="paramname">x_offset</td><td>Amount by which to offset the <a class="el" href="classGdk_1_1GC.html" title="All drawing operations in GDK take a graphics context (GC) argument.">GC</a> in the X direction. </td></tr>
381
<tr><td class="paramname">y_offset</td><td>Amount by which to offset the <a class="el" href="classGdk_1_1GC.html" title="All drawing operations in GDK take a graphics context (GC) argument.">GC</a> in the Y direction. </td></tr>
388
<a class="anchor" id="ada203718d98a1305eb8c93d5cd2b2356"></a><!-- doxytag: member="Gdk::GC::set_background" ref="ada203718d98a1305eb8c93d5cd2b2356" args="(const Color &color)" -->
389
<div class="memitem">
390
<div class="memproto">
391
<table class="memname">
393
<td class="memname">void Gdk::GC::set_background </td>
395
<td class="paramtype">const <a class="el" href="classGdk_1_1Color.html">Color</a>& </td>
396
<td class="paramname"><em>color</em></td><td>)</td>
403
<p>Sets the background color for a graphics context. </p>
404
<p>Note that this function uses <em>color->pixel</em>, use <a class="el" href="classGdk_1_1GC.html#acd78b85d14212d71a1af38b8b1524c5d" title="Set the background color of a GC using an unallocated color.">set_rgb_bg_color()</a> to specify the background color as red, green, blue components.</p>
405
<p>Deprecated: 2.22: Use gdk_cairo_set_source_color() to use a <a class="el" href="classGdk_1_1Color.html" title="Gdk::Color is used to describe an allocated or unallocated color.">Gdk::Color</a> as the source in <a class="el" href="namespaceGdk_1_1Cairo.html">Cairo</a>. Note that if you want to draw a background and a foreground in <a class="el" href="namespaceGdk_1_1Cairo.html">Cairo</a>, you need to call drawing functions (like cairo_fill()) twice. </p>
406
<dl><dt><b>Parameters:</b></dt><dd>
407
<table class="params">
408
<tr><td class="paramname">color</td><td>The new background color. </td></tr>
415
<a class="anchor" id="acc35c552632d7eb9a46d02de6be952f8"></a><!-- doxytag: member="Gdk::GC::set_clip_mask" ref="acc35c552632d7eb9a46d02de6be952f8" args="(const Glib::RefPtr< Bitmap > &mask)" -->
416
<div class="memitem">
417
<div class="memproto">
418
<table class="memname">
420
<td class="memname">void Gdk::GC::set_clip_mask </td>
422
<td class="paramtype">const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a>< <a class="el" href="classGdk_1_1Bitmap.html">Bitmap</a> >& </td>
423
<td class="paramname"><em>mask</em></td><td>)</td>
430
<p>Sets the clip mask for a graphics context from a bitmap. </p>
431
<p>The clip mask is interpreted relative to the clip origin. (See <a class="el" href="classGdk_1_1GC.html#afa0f2fc8b4c78db4feed66b5806db1bf" title="Sets the origin of the clip mask.">set_clip_origin()</a>).</p>
432
<p>Deprecated: 2.22: Use cairo_mask() instead. </p>
433
<dl><dt><b>Parameters:</b></dt><dd>
434
<table class="params">
435
<tr><td class="paramname">mask</td><td>A bitmap. </td></tr>
442
<a class="anchor" id="afa0f2fc8b4c78db4feed66b5806db1bf"></a><!-- doxytag: member="Gdk::GC::set_clip_origin" ref="afa0f2fc8b4c78db4feed66b5806db1bf" args="(int x, int y)" -->
443
<div class="memitem">
444
<div class="memproto">
445
<table class="memname">
447
<td class="memname">void Gdk::GC::set_clip_origin </td>
449
<td class="paramtype">int </td>
450
<td class="paramname"><em>x</em>, </td>
453
<td class="paramkey"></td>
455
<td class="paramtype">int </td>
456
<td class="paramname"><em>y</em> </td>
467
<p>Sets the origin of the clip mask. </p>
468
<p>The coordinates are interpreted relative to the upper-left corner of the destination drawable of the current operation.</p>
469
<p>Deprecated: 2.22: Use cairo_translate() before applying the clip path in <a class="el" href="namespaceGdk_1_1Cairo.html">Cairo</a>. </p>
470
<dl><dt><b>Parameters:</b></dt><dd>
471
<table class="params">
472
<tr><td class="paramname">x</td><td>The x-coordinate of the origin. </td></tr>
473
<tr><td class="paramname">y</td><td>The y-coordinate of the origin. </td></tr>
480
<a class="anchor" id="a8df6e778b7312f3f198842aea3f7bb43"></a><!-- doxytag: member="Gdk::GC::set_clip_rectangle" ref="a8df6e778b7312f3f198842aea3f7bb43" args="(const Rectangle &rectangle)" -->
481
<div class="memitem">
482
<div class="memproto">
483
<table class="memname">
485
<td class="memname">void Gdk::GC::set_clip_rectangle </td>
487
<td class="paramtype">const <a class="el" href="classGdk_1_1Rectangle.html">Rectangle</a>& </td>
488
<td class="paramname"><em>rectangle</em></td><td>)</td>
495
<p>Sets the clip mask for a graphics context from a rectangle. </p>
496
<p>The clip mask is interpreted relative to the clip origin. (See <a class="el" href="classGdk_1_1GC.html#afa0f2fc8b4c78db4feed66b5806db1bf" title="Sets the origin of the clip mask.">set_clip_origin()</a>).</p>
497
<p>Deprecated: 2.22: Use cairo_rectangle() and cairo_clip() in <a class="el" href="namespaceGdk_1_1Cairo.html">Cairo</a>. </p>
498
<dl><dt><b>Parameters:</b></dt><dd>
499
<table class="params">
500
<tr><td class="paramname">rectangle</td><td>The rectangle to clip to. </td></tr>
507
<a class="anchor" id="a9f83feb6a71dcea826f80f65f778eff8"></a><!-- doxytag: member="Gdk::GC::set_clip_rectangle" ref="a9f83feb6a71dcea826f80f65f778eff8" args="(Rectangle &rectangle)" -->
508
<div class="memitem">
509
<div class="memproto">
510
<table class="memname">
512
<td class="memname">void Gdk::GC::set_clip_rectangle </td>
514
<td class="paramtype"><a class="el" href="classGdk_1_1Rectangle.html">Rectangle</a>& </td>
515
<td class="paramname"><em>rectangle</em></td><td>)</td>
522
<p>Sets the clip mask for a graphics context from a rectangle. </p>
523
<p>The clip mask is interpreted relative to the clip origin. (See <a class="el" href="classGdk_1_1GC.html#afa0f2fc8b4c78db4feed66b5806db1bf" title="Sets the origin of the clip mask.">set_clip_origin()</a>).</p>
524
<p>Deprecated: 2.22: Use cairo_rectangle() and cairo_clip() in <a class="el" href="namespaceGdk_1_1Cairo.html">Cairo</a>. </p>
525
<dl class="deprecated"><dt><b><a class="el" href="deprecated.html#_deprecated000013">Deprecated:</a></b></dt><dd>Use <a class="el" href="classGdk_1_1GC.html#a8df6e778b7312f3f198842aea3f7bb43" title="Sets the clip mask for a graphics context from a rectangle.">set_clip_rectangle(const Rectangle& rectangle)</a> instead. </dd></dl>
526
<dl><dt><b>Parameters:</b></dt><dd>
527
<table class="params">
528
<tr><td class="paramname">rectangle</td><td>The rectangle to clip to. </td></tr>
535
<a class="anchor" id="a6109789b4e63e62443fa9433c77525e8"></a><!-- doxytag: member="Gdk::GC::set_clip_region" ref="a6109789b4e63e62443fa9433c77525e8" args="(const Region &region)" -->
536
<div class="memitem">
537
<div class="memproto">
538
<table class="memname">
540
<td class="memname">void Gdk::GC::set_clip_region </td>
542
<td class="paramtype">const <a class="el" href="classGdk_1_1Region.html">Region</a>& </td>
543
<td class="paramname"><em>region</em></td><td>)</td>
550
<p>Sets the clip mask for a graphics context from a region structure. </p>
551
<p>The clip mask is interpreted relative to the clip origin. (See <a class="el" href="classGdk_1_1GC.html#afa0f2fc8b4c78db4feed66b5806db1bf" title="Sets the origin of the clip mask.">set_clip_origin()</a>).</p>
552
<p>Deprecated: 2.22: Use gdk_cairo_region() and cairo_clip() in <a class="el" href="namespaceGdk_1_1Cairo.html">Cairo</a>. </p>
553
<dl><dt><b>Parameters:</b></dt><dd>
554
<table class="params">
555
<tr><td class="paramname">region</td><td>The <a class="el" href="classGdk_1_1Region.html" title="This is an opaque data type holding a set of arbitrary pixels, and is usually used for clipping graph...">Gdk::Region</a>. </td></tr>
562
<a class="anchor" id="a123478ef0e9046f8ac1d0e1179ef4e04"></a><!-- doxytag: member="Gdk::GC::set_colormap" ref="a123478ef0e9046f8ac1d0e1179ef4e04" args="(const Glib::RefPtr< Colormap > &colormap)" -->
563
<div class="memitem">
564
<div class="memproto">
565
<table class="memname">
567
<td class="memname">void Gdk::GC::set_colormap </td>
569
<td class="paramtype">const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a>< <a class="el" href="classGdk_1_1Colormap.html">Colormap</a> >& </td>
570
<td class="paramname"><em>colormap</em></td><td>)</td>
577
<p>Sets the colormap for the <a class="el" href="classGdk_1_1GC.html" title="All drawing operations in GDK take a graphics context (GC) argument.">GC</a> to the given colormap. </p>
578
<p>The depth of the colormap's visual must match the depth of the drawable for which the <a class="el" href="classGdk_1_1GC.html" title="All drawing operations in GDK take a graphics context (GC) argument.">GC</a> was created.</p>
579
<p>Deprecated: 2.22: There is no replacement. <a class="el" href="namespaceGdk_1_1Cairo.html">Cairo</a> handles colormaps automatically, so there is no need to care about them. </p>
580
<dl><dt><b>Parameters:</b></dt><dd>
581
<table class="params">
582
<tr><td class="paramname">colormap</td><td>A <a class="el" href="classGdk_1_1Colormap.html" title="A Colormap is an object that contains the mapping between the color values stored in memory and the R...">Gdk::Colormap</a>. </td></tr>
589
<a class="anchor" id="aae81765dc15ad450d56f69219d73ffad"></a><!-- doxytag: member="Gdk::GC::set_dashes" ref="aae81765dc15ad450d56f69219d73ffad" args="(int dash_offset, gint8 *dash_list, int n)" -->
590
<div class="memitem">
591
<div class="memproto">
592
<table class="memname">
594
<td class="memname">void Gdk::GC::set_dashes </td>
596
<td class="paramtype">int </td>
597
<td class="paramname"><em>dash_offset</em>, </td>
600
<td class="paramkey"></td>
602
<td class="paramtype">gint8 * </td>
603
<td class="paramname"><em>dash_list</em>, </td>
606
<td class="paramkey"></td>
608
<td class="paramtype">int </td>
609
<td class="paramname"><em>n</em> </td>
620
<p>Sets the way dashed-lines are drawn. </p>
621
<p>Lines will be drawn with alternating on and off segments of the lengths specified in <em>dash_list</em>. The manner in which the on and off segments are drawn is determined by the <em>line_style</em> value of the <a class="el" href="classGdk_1_1GC.html" title="All drawing operations in GDK take a graphics context (GC) argument.">GC</a>. (This can be changed with <a class="el" href="classGdk_1_1GC.html#a6ffd36fdf941a6ee478c15b2d1ec0a10" title="Sets various attributes of how lines are drawn.">set_line_attributes()</a>.)</p>
622
<p>The <em>dash_offset</em> defines the phase of the pattern, specifying how many pixels into the dash-list the pattern should actually begin.</p>
623
<p>Deprecated: 2.22: Use cairo_set_dash() to set the dash in <a class="el" href="namespaceGdk_1_1Cairo.html">Cairo</a>. </p>
624
<dl><dt><b>Parameters:</b></dt><dd>
625
<table class="params">
626
<tr><td class="paramname">dash_offset</td><td>The phase of the dash pattern. </td></tr>
627
<tr><td class="paramname">dash_list</td><td>An array of dash lengths. </td></tr>
628
<tr><td class="paramname">n</td><td>The number of elements in <em>dash_list</em>. </td></tr>
635
<a class="anchor" id="a8d45034c577e55fd350a8556a3c242ff"></a><!-- doxytag: member="Gdk::GC::set_exposures" ref="a8d45034c577e55fd350a8556a3c242ff" args="(bool exposures)" -->
636
<div class="memitem">
637
<div class="memproto">
638
<table class="memname">
640
<td class="memname">void Gdk::GC::set_exposures </td>
642
<td class="paramtype">bool </td>
643
<td class="paramname"><em>exposures</em></td><td>)</td>
650
<p>Sets whether copying non-visible portions of a drawable using this graphics context generate exposure events for the corresponding regions of the destination drawable. </p>
651
<p>(See gdk_draw_drawable()).</p>
652
<p>Deprecated: 2.22: There is no replacement. If you need to control exposures, you must use drawing operations of the underlying window system or use <a class="el" href="classGdk_1_1Window.html#afd705d134dd0753dfd5d76bcb4988c27" title="A convenience wrapper around invalidate_region() which invalidates a rectangular region.">Gdk::Window::invalidate_rect()</a>. <a class="el" href="namespaceGdk_1_1Cairo.html">Cairo</a> will never generate exposures. </p>
653
<dl><dt><b>Parameters:</b></dt><dd>
654
<table class="params">
655
<tr><td class="paramname">exposures</td><td>If <code>true</code>, exposure events will be generated. </td></tr>
662
<a class="anchor" id="ae95140c1494e4450ca22fccded72337c"></a><!-- doxytag: member="Gdk::GC::set_fill" ref="ae95140c1494e4450ca22fccded72337c" args="(Fill fill)" -->
663
<div class="memitem">
664
<div class="memproto">
665
<table class="memname">
667
<td class="memname">void Gdk::GC::set_fill </td>
669
<td class="paramtype"><a class="el" href="group__gdkmmEnums.html#gaf945088bf264cc01bf858c3468d2a451">Fill</a> </td>
670
<td class="paramname"><em>fill</em></td><td>)</td>
677
<p>Set the fill mode for a graphics context. </p>
678
<p>Deprecated: 2.22: You can achieve tiling in <a class="el" href="namespaceGdk_1_1Cairo.html">Cairo</a> by using cairo_pattern_set_extend() on the source. For stippling, see the deprecation comments on <a class="el" href="classGdk_1_1GC.html#af6c8c1f159ab300994417aa6d1a2ff4a" title="Set the stipple bitmap for a graphics context.">set_stipple()</a>. </p>
679
<dl><dt><b>Parameters:</b></dt><dd>
680
<table class="params">
681
<tr><td class="paramname">fill</td><td>The new fill mode. </td></tr>
688
<a class="anchor" id="ae16759ef3ee9b3696021369f61d62fea"></a><!-- doxytag: member="Gdk::GC::set_foreground" ref="ae16759ef3ee9b3696021369f61d62fea" args="(const Color &color)" -->
689
<div class="memitem">
690
<div class="memproto">
691
<table class="memname">
693
<td class="memname">void Gdk::GC::set_foreground </td>
695
<td class="paramtype">const <a class="el" href="classGdk_1_1Color.html">Color</a>& </td>
696
<td class="paramname"><em>color</em></td><td>)</td>
703
<p>Sets the foreground color for a graphics context. </p>
704
<p>Note that this function uses <em>color->pixel</em>, use <a class="el" href="classGdk_1_1GC.html#afeebd8928915e5836ed5a2c0d13dcd09" title="Set the foreground color of a GC using an unallocated color.">set_rgb_fg_color()</a> to specify the foreground color as red, green, blue components.</p>
705
<p>Deprecated: 2.22: Use gdk_cairo_set_source_color() to use a <a class="el" href="classGdk_1_1Color.html" title="Gdk::Color is used to describe an allocated or unallocated color.">Gdk::Color</a> as the source in <a class="el" href="namespaceGdk_1_1Cairo.html">Cairo</a>. </p>
706
<dl><dt><b>Parameters:</b></dt><dd>
707
<table class="params">
708
<tr><td class="paramname">color</td><td>The new foreground color. </td></tr>
715
<a class="anchor" id="ade0340da1088f4ecdde89e9180212e0b"></a><!-- doxytag: member="Gdk::GC::set_function" ref="ade0340da1088f4ecdde89e9180212e0b" args="(Function function)" -->
716
<div class="memitem">
717
<div class="memproto">
718
<table class="memname">
720
<td class="memname">void Gdk::GC::set_function </td>
722
<td class="paramtype"><a class="el" href="group__gdkmmEnums.html#gaf1365a8c559e749927e68d3ae723a47b">Function</a> </td>
723
<td class="paramname"><em>function</em></td><td>)</td>
730
<p>Determines how the current pixel values and the pixel values being drawn are combined to produce the final pixel values. </p>
731
<p>Deprecated: 2.22: Use cairo_set_operator() with <a class="el" href="namespaceGdk_1_1Cairo.html">Cairo</a>. </p>
732
<dl><dt><b>Parameters:</b></dt><dd>
733
<table class="params">
734
<tr><td class="paramname">function</td><td>The Gdk::Function to use. </td></tr>
741
<a class="anchor" id="a6ffd36fdf941a6ee478c15b2d1ec0a10"></a><!-- doxytag: member="Gdk::GC::set_line_attributes" ref="a6ffd36fdf941a6ee478c15b2d1ec0a10" args="(int line_width, LineStyle line_style, CapStyle cap_style, JoinStyle join_style)" -->
742
<div class="memitem">
743
<div class="memproto">
744
<table class="memname">
746
<td class="memname">void Gdk::GC::set_line_attributes </td>
748
<td class="paramtype">int </td>
749
<td class="paramname"><em>line_width</em>, </td>
752
<td class="paramkey"></td>
754
<td class="paramtype"><a class="el" href="group__gdkmmEnums.html#gac5dcb29dfe744e4e8b72693b392ac06e">LineStyle</a> </td>
755
<td class="paramname"><em>line_style</em>, </td>
758
<td class="paramkey"></td>
760
<td class="paramtype"><a class="el" href="group__gdkmmEnums.html#ga8cb10204a21a8576e6977249380ae9a6">CapStyle</a> </td>
761
<td class="paramname"><em>cap_style</em>, </td>
764
<td class="paramkey"></td>
766
<td class="paramtype"><a class="el" href="group__gdkmmEnums.html#ga91500dd25e90700bb632791263c7d9ec">JoinStyle</a> </td>
767
<td class="paramname"><em>join_style</em> </td>
778
<p>Sets various attributes of how lines are drawn. </p>
779
<p>See the corresponding members of Gdk::GCValues for full explanations of the arguments.</p>
780
<p>Deprecated: 2.22: Use the <a class="el" href="namespaceGdk_1_1Cairo.html">Cairo</a> functions cairo_set_line_width(), cairo_set_line_join(), cairo_set_line_cap() and cairo_set_dash() to affect the stroking behavior in <a class="el" href="namespaceGdk_1_1Cairo.html">Cairo</a>. Keep in mind that the default attributes of a #cairo_t are different from the default attributes of a <a class="el" href="classGdk_1_1GC.html" title="All drawing operations in GDK take a graphics context (GC) argument.">Gdk::GC</a>. </p>
781
<dl><dt><b>Parameters:</b></dt><dd>
782
<table class="params">
783
<tr><td class="paramname">line_width</td><td>The width of lines. </td></tr>
784
<tr><td class="paramname">line_style</td><td>The dash-style for lines. </td></tr>
785
<tr><td class="paramname">cap_style</td><td>The manner in which the ends of lines are drawn. </td></tr>
786
<tr><td class="paramname">join_style</td><td>The in which lines are joined together. </td></tr>
793
<a class="anchor" id="acd78b85d14212d71a1af38b8b1524c5d"></a><!-- doxytag: member="Gdk::GC::set_rgb_bg_color" ref="acd78b85d14212d71a1af38b8b1524c5d" args="(const Color &color)" -->
794
<div class="memitem">
795
<div class="memproto">
796
<table class="memname">
798
<td class="memname">void Gdk::GC::set_rgb_bg_color </td>
800
<td class="paramtype">const <a class="el" href="classGdk_1_1Color.html">Color</a>& </td>
801
<td class="paramname"><em>color</em></td><td>)</td>
808
<p>Set the background color of a <a class="el" href="classGdk_1_1GC.html" title="All drawing operations in GDK take a graphics context (GC) argument.">GC</a> using an unallocated color. </p>
809
<p>The pixel value for the color will be determined using GdkRGB. If the colormap for the <a class="el" href="classGdk_1_1GC.html" title="All drawing operations in GDK take a graphics context (GC) argument.">GC</a> has not previously been initialized for GdkRGB, then for pseudo-color colormaps (colormaps with a small modifiable number of colors), a colorcube will be allocated in the colormap.</p>
810
<p>Calling this function for a <a class="el" href="classGdk_1_1GC.html" title="All drawing operations in GDK take a graphics context (GC) argument.">GC</a> without a colormap is an error.</p>
811
<p>Deprecated: 2.22: Use gdk_cairo_set_source_color() instead. </p>
812
<dl><dt><b>Parameters:</b></dt><dd>
813
<table class="params">
814
<tr><td class="paramname">color</td><td>An unallocated <a class="el" href="classGdk_1_1Color.html" title="Gdk::Color is used to describe an allocated or unallocated color.">Gdk::Color</a>. </td></tr>
821
<a class="anchor" id="afeebd8928915e5836ed5a2c0d13dcd09"></a><!-- doxytag: member="Gdk::GC::set_rgb_fg_color" ref="afeebd8928915e5836ed5a2c0d13dcd09" args="(const Color &color)" -->
822
<div class="memitem">
823
<div class="memproto">
824
<table class="memname">
826
<td class="memname">void Gdk::GC::set_rgb_fg_color </td>
828
<td class="paramtype">const <a class="el" href="classGdk_1_1Color.html">Color</a>& </td>
829
<td class="paramname"><em>color</em></td><td>)</td>
836
<p>Set the foreground color of a <a class="el" href="classGdk_1_1GC.html" title="All drawing operations in GDK take a graphics context (GC) argument.">GC</a> using an unallocated color. </p>
837
<p>The pixel value for the color will be determined using GdkRGB. If the colormap for the <a class="el" href="classGdk_1_1GC.html" title="All drawing operations in GDK take a graphics context (GC) argument.">GC</a> has not previously been initialized for GdkRGB, then for pseudo-color colormaps (colormaps with a small modifiable number of colors), a colorcube will be allocated in the colormap.</p>
838
<p>Calling this function for a <a class="el" href="classGdk_1_1GC.html" title="All drawing operations in GDK take a graphics context (GC) argument.">GC</a> without a colormap is an error.</p>
839
<p>Deprecated: 2.22: Use gdk_cairo_set_source_color() instead. </p>
840
<dl><dt><b>Parameters:</b></dt><dd>
841
<table class="params">
842
<tr><td class="paramname">color</td><td>An unallocated <a class="el" href="classGdk_1_1Color.html" title="Gdk::Color is used to describe an allocated or unallocated color.">Gdk::Color</a>. </td></tr>
849
<a class="anchor" id="af6c8c1f159ab300994417aa6d1a2ff4a"></a><!-- doxytag: member="Gdk::GC::set_stipple" ref="af6c8c1f159ab300994417aa6d1a2ff4a" args="(const Glib::RefPtr< Pixmap > &stipple)" -->
850
<div class="memitem">
851
<div class="memproto">
852
<table class="memname">
854
<td class="memname">void Gdk::GC::set_stipple </td>
856
<td class="paramtype">const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a>< <a class="el" href="classGdk_1_1Pixmap.html">Pixmap</a> >& </td>
857
<td class="paramname"><em>stipple</em></td><td>)</td>
864
<p>Set the stipple bitmap for a graphics context. </p>
865
<p>The stipple will only be used if the fill mode is Gdk::STIPPLED or Gdk::OPAQUE_STIPPLED.</p>
866
<p>Deprecated: 2.22: Stippling has no direct replacement in <a class="el" href="namespaceGdk_1_1Cairo.html">Cairo</a>. If you want to achieve an identical look, you can use the stipple bitmap as a mask. Most likely, this involves rendering the source to an intermediate surface using cairo_push_group() first, so that you can then use cairo_mask() to achieve the stippled look. </p>
867
<dl><dt><b>Parameters:</b></dt><dd>
868
<table class="params">
869
<tr><td class="paramname">stipple</td><td>The new stipple bitmap. </td></tr>
876
<a class="anchor" id="a2d1af56f1e93a7bc88340495e2cb3ffc"></a><!-- doxytag: member="Gdk::GC::set_subwindow" ref="a2d1af56f1e93a7bc88340495e2cb3ffc" args="(SubwindowMode mode)" -->
877
<div class="memitem">
878
<div class="memproto">
879
<table class="memname">
881
<td class="memname">void Gdk::GC::set_subwindow </td>
883
<td class="paramtype"><a class="el" href="group__gdkmmEnums.html#gaae37637a79c9ee9822c925f30748eafd">SubwindowMode</a> </td>
884
<td class="paramname"><em>mode</em></td><td>)</td>
891
<p>Sets how drawing with this <a class="el" href="classGdk_1_1GC.html" title="All drawing operations in GDK take a graphics context (GC) argument.">GC</a> on a window will affect child windows of that window. </p>
892
<p>Deprecated: 2.22: There is no replacement. If you need to control subwindows, you must use drawing operations of the underlying window system manually. <a class="el" href="namespaceGdk_1_1Cairo.html">Cairo</a> will always use Gdk::INCLUDE_INFERIORS on sources and masks and Gdk::CLIP_BY_CHILDREN on targets. </p>
893
<dl><dt><b>Parameters:</b></dt><dd>
894
<table class="params">
895
<tr><td class="paramname">mode</td><td>The subwindow mode. </td></tr>
902
<a class="anchor" id="aae51d032ddbea405bb177268cab521cc"></a><!-- doxytag: member="Gdk::GC::set_tile" ref="aae51d032ddbea405bb177268cab521cc" args="(const Glib::RefPtr< Pixmap > &tile)" -->
903
<div class="memitem">
904
<div class="memproto">
905
<table class="memname">
907
<td class="memname">void Gdk::GC::set_tile </td>
909
<td class="paramtype">const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a>< <a class="el" href="classGdk_1_1Pixmap.html">Pixmap</a> >& </td>
910
<td class="paramname"><em>tile</em></td><td>)</td>
917
<p>Set a tile pixmap for a graphics context. </p>
918
<p>This will only be used if the fill mode is Gdk::TILED.</p>
919
<p>Deprecated: 2.22: The following code snippet sets a tiling <a class="el" href="classGdk_1_1Pixmap.html" title="Pixmaps are offscreen drawables.">Gdk::Pixmap</a> as the source in <a class="el" href="namespaceGdk_1_1Cairo.html">Cairo</a>: |[gdk_cairo_set_source_pixmap (cr, tile, ts_origin_x, ts_origin_y); cairo_pattern_set_extend (cairo_get_source (cr), CAIRO_EXTEND_REPEAT);]| </p>
920
<dl><dt><b>Parameters:</b></dt><dd>
921
<table class="params">
922
<tr><td class="paramname">tile</td><td>The new tile pixmap. </td></tr>
929
<a class="anchor" id="a86994e1325f39ae18278cbd6c298bcac"></a><!-- doxytag: member="Gdk::GC::set_ts_origin" ref="a86994e1325f39ae18278cbd6c298bcac" args="(int x, int y)" -->
930
<div class="memitem">
931
<div class="memproto">
932
<table class="memname">
934
<td class="memname">void Gdk::GC::set_ts_origin </td>
936
<td class="paramtype">int </td>
937
<td class="paramname"><em>x</em>, </td>
940
<td class="paramkey"></td>
942
<td class="paramtype">int </td>
943
<td class="paramname"><em>y</em> </td>
954
<p>Set the origin when using tiles or stipples with the <a class="el" href="classGdk_1_1GC.html" title="All drawing operations in GDK take a graphics context (GC) argument.">GC</a>. </p>
955
<p>The tile or stipple will be aligned such that the upper left corner of the tile or stipple will coincide with this point.</p>
956
<p>Deprecated: 2.22: You can set the origin for tiles and stipples in <a class="el" href="namespaceGdk_1_1Cairo.html">Cairo</a> by changing the source's matrix using cairo_pattern_set_matrix(). Or you can specify it with gdk_cairo_set_source_pixmap() as shown in the example for <a class="el" href="classGdk_1_1GC.html#aae51d032ddbea405bb177268cab521cc" title="Set a tile pixmap for a graphics context.">set_tile()</a>. </p>
957
<dl><dt><b>Parameters:</b></dt><dd>
958
<table class="params">
959
<tr><td class="paramname">x</td><td>The x-coordinate of the origin. </td></tr>
960
<tr><td class="paramname">y</td><td>The y-coordinate of the origin. </td></tr>
967
<hr/><h2>Friends And Related Function Documentation</h2>
968
<a class="anchor" id="a3f214c3e4eba764b69121a337c862bc1"></a><!-- doxytag: member="Gdk::GC::wrap" ref="a3f214c3e4eba764b69121a337c862bc1" args="(GdkGC *object, bool take_copy=false)" -->
969
<div class="memitem">
970
<div class="memproto">
971
<table class="memname">
973
<td class="memname"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a>< <a class="el" href="classGdk_1_1GC.html">Gdk::GC</a> > wrap </td>
975
<td class="paramtype">GdkGC * </td>
976
<td class="paramname"><em>object</em>, </td>
979
<td class="paramkey"></td>
981
<td class="paramtype">bool </td>
982
<td class="paramname"><em>take_copy</em> = <code>false</code> </td>
987
<td></td><td><code> [related]</code></td>
993
<p>A <a class="elRef" href="../../../glibmm-2.4/reference/html/namespaceGlib.html#a671306f4a3a0cae5ab4d7a9d54886592">Glib::wrap()</a> method for this object. </p>
994
<dl><dt><b>Parameters:</b></dt><dd>
995
<table class="params">
996
<tr><td class="paramname">object</td><td>The C instance. </td></tr>
997
<tr><td class="paramname">take_copy</td><td>False if the result should take ownership of the C instance. True if it should take a new copy or ref. </td></tr>
1001
<dl class="return"><dt><b>Returns:</b></dt><dd>A C++ instance that wraps this C instance. </dd></dl>
1005
<hr/>The documentation for this class was generated from the following file:<ul>
1009
<hr class="footer"/><address class="footer"><small>Generated on Fri Jul 8 2011 13:31:44 for gtkmm by 
1010
<a href="http://www.doxygen.org/index.html">
1011
<img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.7.3 </small></address>
added
removed
share/doc/gtkmm-2.4/reference/html/classGdk_1_1GC.html
