summaryrefslogtreecommitdiff
path: root/doc/public/xml/cairo-win32.xml
diff options
context:
space:
mode:
Diffstat (limited to 'doc/public/xml/cairo-win32.xml')
-rw-r--r--doc/public/xml/cairo-win32.xml9
1 files changed, 8 insertions, 1 deletions
diff --git a/doc/public/xml/cairo-win32.xml b/doc/public/xml/cairo-win32.xml
index 2933eec..edbb10b 100644
--- a/doc/public/xml/cairo-win32.xml
+++ b/doc/public/xml/cairo-win32.xml
@@ -143,7 +143,7 @@ possible to draw to the surface.
</para>
<para>
The returned surface will be wrapped using the paginated surface to
-provide correct complex rendering behaviour; <link linkend="show-page"><function>show_page()</function></link> and
+provide correct complex rendering behaviour; <link linkend="cairo-surface-show-page"><function>cairo_surface_show_page()</function></link> and
associated methods must be used for correct output.
</para><variablelist role="params">
<varlistentry><term><parameter>hdc</parameter>&#160;:</term>
@@ -160,6 +160,13 @@ associated methods must be used for correct output.
<para>
Returns the HDC associated with this surface, or <link linkend="NULL:CAPS"><literal>NULL</literal></link> if none.
Also returns <link linkend="NULL:CAPS"><literal>NULL</literal></link> if the surface is not a win32 surface.
+</para>
+<para>
+A call to <link linkend="cairo-surface-flush"><function>cairo_surface_flush()</function></link> is required before using the HDC to
+ensure that all pending drawing operations are finished and to
+restore any temporary modification cairo has made to its state. A
+call to <link linkend="cairo-surface-mark-dirty"><function>cairo_surface_mark_dirty()</function></link> is required after the state or
+the content of the HDC has been modified.
</para><variablelist role="params">
<varlistentry><term><parameter>surface</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="cairo-surface-t"><type>cairo_surface_t</type></link>