This documentation is archived and is not being maintained.

Image.SelectActiveFrame Method

Selects the frame specified by the dimension and index.

[Visual Basic]
Public Function SelectActiveFrame( _
   ByVal dimension As FrameDimension, _
   ByVal frameIndex As Integer _
) As Integer
public int SelectActiveFrame(
 FrameDimension dimension,
 int frameIndex
public: int SelectActiveFrame(
 FrameDimension* dimension,
 int frameIndex
public function SelectActiveFrame(
   dimension : FrameDimension,
 frameIndex : int
) : int;


A FrameDimension object that specifies the identity of the dimension type.
The index of the active frame.

Return Value

The index of the active frame.


The possible values of the dimensionID parameter are properties of the FrameDimension object. Thesecan be used to identify an image by its time, resolution, or page number.

Calling this method causes all changes made to the previous frame to be discarded. Before selecting another frame, save all changes made to the current frame, including changes to pixel values and properties.


Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family

See Also

Image Class | Image Members | System.Drawing Namespace