rvico TRichView Reference | Types

TRVExtraItemProperty Type

Top  Previous  Next

Unit RVItem;

type

 TRVExtraItemProperty =

  (rvepUnknown, rvepVShift, rvepVShiftAbs,

   rvepImageWidth, rvepImageHeight,

   rvepTransparent, rvepTransparentMode,

   rvepTransparentColor, rvepMinHeightOnPage,

   rvepSpacing, rvepResizable,

   rvepDeleteProtect, rvepNoHTMLImageSize,

   rvepAnimationInterval, rvepVisible);

Identifies item property of integer type.

Property

Applicable To

Default Value

Meaning

rvepUnknown



Not a property. For internal use.

rvepVShift

0

Vertical offset, in % of item height (default), or in pixels (see rvepVShiftAbs).

Negative values move the item down, positive move it up (relative to the position specified in VAlign)

rvepVShiftAbs

0

If non-zero, rvepVShift defines vertical offset in pixels instead of %.

rvepImageWidth, rvepImageHeight

0

If set to positive value, define size of the image. The actual image is not modified, it is just drawn stretched.

rvepTransparent, rvepTransparentMode, rvepTransparentColor

(if they are TBitmap)

 

Correspond to properties of TBitmap: Transparent, TransparentMode, TransparentColor.

Limitations:

transparency is turned off in 256-color mode;
transparency is not supported when printing (although print preview shows transparent bitmaps)
TBitmap implementation of transparency is not ideal; sometimes it may cause weird colors for 256-color images (probably, it was fixed in last versions of Delphi)

rvepMinHeightOnPage

0

Affects printing, allows printing large pictures on several pages. Positive value defines minimal height of part of image allowed to be on page.

For example:

1 the image can be printed on two or more pages, it can separated between pages in any place;
100 if the rest of page can contain >= 100 pixels of the image, the image will be separated, otherwise it will be printed on single page;
0 the image/control will be printed on single page.

Do not overuse this feature, it has limitations:

such images/controls are always printed from new line;
for control, OnPrintComponent must return bitmap having exactly the size of the control (if this property = 0, you can return larger bitmap and it will be stretched allowing to create a better printing output)

rvepSpacing

1

Spacing around the item. Must be a positive value.

Default value is 1 (for backward compatibility; very probably, it will be changed to 0).

rvepResizable

1 (for pictures and hot-pictures),

0 (for controls).

Allows resizing with mouse

0 no resizing;
non-zero value resizing is allowed.

rvepDeleteProtect

all non-text items

0

0 – no protection;
non-zero value – item cannot be deleted in editing operations.

See also: rvprDeleteProtect option of Protection for text style.

rvepNoHTMLImageSize

0

If non-zero, image size is not saved in HTML, even if rvsoImageSizes is included in the Options parameter for SaveHTML/SaveHTMLEx

This option is ignored for pictures and hot-pictures, if rvepImageWidth or rvepImageHeight properties are non-zero.

rvepAnimationInterval

(if they are TBitmap)

0

Animation delay in 1/100 of second.

If nonzero and rvepImageWidth and/or rvepImageHeight are defined, playing bitmap animation (in imagewidth x imageheight frame)

rvepVisible

1

Set to 0 to hide the control.

See also

TRVExtraItemStrProperty

See also methods of TRichView

SetItemExtraIntProperty,
GetItemExtraIntProperty.

See also methods of TRichViewEdit

SetItemExtraIntPropertyEd,
SetCurrentItemExtraIntProperty,
GetCurrentItemExtraIntProperty.


RichView © Sergey Tkachenko