VirtualPictures Method, SftTree Object


	SftTree.VirtualPictures Method	Softel vdm, Inc.

Defines the maximum graphics sizes when using a virtual data source.

Deprecated - Provided for compatibility with earlier versions only - Use VirtualImageSizes instead

Syntax

		VB.NET	object.VirtualPictures(ByVal ItemPic As System.Drawing.Image, ByVal CellPic As System.Drawing.Image, ByVal LabelPic As System.Drawing.Image, ByVal RowPic As System.Drawing.Image)
		VB	object.VirtualPictures(ItemPic As IPictureDisp, CellPic As IPictureDisp, LabelPic As IPictureDisp, RowPic As IPictureDisp)
		C#.NET	void object.VirtualPictures(System.Drawing.Image ItemPic, System.Drawing.Image CellPic, System.Drawing.Image LabelPic, System.Drawing.Image RowPic);
		VC++	HRESULT object->VirtualPictures(IPictureDisp* ItemPic, IPictureDisp* CellPic, IPictureDisp* LabelPic, IPictureDisp* RowPic);
		C	HRESULT object->raw_VirtualPictures(IPictureDisp* ItemPic, IPictureDisp* CellPic, IPictureDisp* LabelPic, IPictureDisp* RowPic);
		Delphi	procedure object.VirtualPictures(ItemPic : TPicture, CellPic : TPicture, LabelPic : TPicture, RowPic : TPicture);

object

A SftTree object.

ItemPic

A Picture object. This Picture object represents the maximum size of any item graphic. Specify Nothing (NULL) to omit item graphics.

CellPic

A Picture object. This Picture object represents the maximum size of any cell graphic. Specify Nothing (NULL) to omit cell graphics.

LabelPic

A Picture object. This Picture object represents the maximum size of any label graphic. Specify Nothing (NULL) to omit label graphics.

RowPic

A Picture object. This Picture object represents the maximum size of any row header graphic. Specify Nothing (NULL) to omit row header graphics.

Comments

Deprecated - Provided for compatibility with earlier versions only - Use VirtualImageSizes instead

The VirtualPictures method defines the maximum graphics sizes when using a virtual data source.

After defining a tree control as a virtual tree control using the VirtualMode property, the (maximum) graphics sizes must be defined using the VirtualPictures method, so the graphics are enabled and so the control can reserve sufficient space for each graphics component.

In a fixed height tree control, VirtualPictures defines the exact size of each graphics component. In a variable height tree control, the graphics must define the maximum size of each graphics component.

ItemPic defines the item graphic size, CellPic defines the cell graphic size, LabelPic defines the label graphic size and RowPic defines the row header graphic size. If a graphic component is not used, Nothing (or NULL) can be passed as Picture object. In this case the graphic component is not displayed even if the virtual data source callback provides a valid image.

If the tree control is not a virtual tree control (items have been added using Items.Add or Items.Insert), this method will fail.