David Alm: Automated Syncronization with Documentation

2013-06-26T00:30:04Z

Automated Syncronization with Documentation

← Older revision

Revision as of 00:30, 26 June 2013

David Alm: Automated Syncronization with Documentation

2013-06-26T00:10:21Z

Automated Syncronization with Documentation

← Older revision

Revision as of 00:10, 26 June 2013

David Alm: Automated Syncronization with Documentation

2013-06-25T23:52:02Z

Automated Syncronization with Documentation

← Older revision

Revision as of 23:52, 25 June 2013

David Alm: Automated Syncronization with Documentation

2013-06-11T02:44:07Z

Automated Syncronization with Documentation

← Older revision

Revision as of 02:44, 11 June 2013

David Alm: Automated Syncronization with Documentation

2013-06-11T00:15:01Z

Automated Syncronization with Documentation

← Older revision

Revision as of 00:15, 11 June 2013

David Alm: Automated Syncronization with Documentation

2013-06-11T00:04:50Z

Automated Syncronization with Documentation

← Older revision

Revision as of 00:04, 11 June 2013

David Alm: Automated Syncronization with Documentation

2013-06-10T20:27:46Z

Automated Syncronization with Documentation

← Older revision

Revision as of 20:27, 10 June 2013

David Alm: Automated Syncronization with Documentation

2011-11-22T00:15:45Z

Automated Syncronization with Documentation

New page

<b><span style="color:red">
This is a Beta Read Only version of this page.
Please review and send recommendations to [mailto:mitov@mitov.com mitov@mitov.com].
We will enable the editing as soon as we are happy with the overall Wiki site.
</span></b>

== Description ==
Call this method to begin a new graphics container.

Example:

The following example sets a clipping region for a Graphics
object and begins a graphics container. It then sets an
additional clipping region for the container and draws
rectangles that demonstrate the effective clipping region
inside the container.

<code>
var
AGraphics : IGPGraphics;
APath : GraphicsPath ;
ABlackPen : IGPPen;
AContainer : IGPGraphicsContainer;

begin
AGraphics := TGPGraphics.Create( ACanvas );

// Set the clipping region for the Graphics object.
AGraphics.SetClip(MakeRect(10, 10, 150, 150));

// Begin a graphics container.
AContainer = AGraphics.BeginContainer();

// Set an additional clipping region for the container.
AGraphics.SetClip( MakeRect( 100, 50, 100, 75 ));

// Fill a red rectangle in the container.
AGraphics.FillRectangle( TGPSolidBrush.Create( aclRed ), 0, 0, 400, 400);

// End the container, and fill the same rectangle with blue.
graphics.EndContainer( AContainer );
AGraphics.FillRectangle( TGPSolidBrush.Create( aclBlue ), 0, 0, 400, 400);

// Set the clipping region to infinite, and draw the outlines
// of the two previous clipping regions.
AGraphics.ResetClip();
ABlack := TGPPen.Create( aclBlack, 2.0 );
AGraphics.DrawRectangle( ABlack, 10, 10, 150, 150 );
AGraphics.DrawRectangle( ABlack, 100, 50, 100, 75 );
end;
</code>

Remarks
Use this method to create nested graphics containers.
Graphics containers are used to retain graphics state, such
as transformations, clipping regions, and various rendering
properties.

The BeginContainer method returns a value of type
TGPGraphicsContainer. When you have finished using a
container, pass that value to the EndContainer method. The
TGPGraphicsContainer data type is defined in Gdiplusenums.h.

When you call the BeginContainer method of a Graphics object,
an information block that holds the state of the Graphics
object is put on a stack. The BeginContainer method returns a
value that identifies that information block. When you pass
the identifying value to the EndContainer method, the
information block is removed from the stack and is used to
restore the Graphics object to the state it was in at the
time of the BeginContainer call.

Containers can be nested; that is, you can call the
BeginContainer method several times before you call the
EndContainer method. Each time you call the BeginContainer
method, an information block is put on the stack, and you
receive an identifier for the information block. When you
pass one of those identifiers to the EndContainer method, the
Graphics object is returned to the state it was in at the
time of the BeginContainer call that returned that particular
identifier. The information block placed on the stack by that
BeginContainer call is removed from the stack, and all
information blocks placed on that stack after that
BeginContainer call are also removed.

Calls to the Save method place information blocks on the same
stack as calls to the BeginContainer method. Just as an
EndContainer call is paired with a BeginContainer call, a
Restore call is paired with a Save call.

Caution When you call EndContainer, all information blocks
placed on the stack (by Save or by BeginContainer) after the
corresponding call to BeginContainer are removed from the
stack. Likewise, when you call Restore, all information
blocks placed on the stack (by Save or by BeginContainer)
after the corresponding call to Save are removed from the
stack.

For more information about graphics containers, see "Nested
Graphics Containers" on MSDN.

IGPGraphics.BeginContainer - Revision history

David Alm: Automated Syncronization with Documentation

David Alm: Automated Syncronization with Documentation

David Alm: Automated Syncronization with Documentation

David Alm: Automated Syncronization with Documentation

David Alm: Automated Syncronization with Documentation

David Alm: Automated Syncronization with Documentation

David Alm: Automated Syncronization with Documentation

David Alm: Automated Syncronization with Documentation