IPen.BlockRepaint [Property][Get/Set]

Use this property to halt or continue any drawing updates to this pen.

Defined As

• [VBA] Boolean BlockRepaint
• [Cicode] INT BlockRepaint
• [C++] VARIANT_BOOL BlockRepaint

Execution Result

If the property get/set succeeds the return value will be Success. If the return variable is bad then the return value will be InvalidArgument. If the pen is deleted then the return value will be GeneralFailure.

Remarks

This property is useful if you are modifying several properties at once as it will help reduce flicker and the amount of processing necessary. Simply set the property to True (-1), change as many properties as you want, and then set the property to False (0).

Calling Syntax

Assumes you have passed a valid pen object into the function.

[VBA]

Sub Example(pen As Object)

 Dim blockRepaint As Boolean

	 `Getting Property value

   blockRepaint = pen.BlockRepaint

   `Setting Property value

   pen.BlockRepaint = True

End Sub

[Cicode]

FUNCTION Example(OBJECT hPen)

	INT bBlockRepaint;

		// Getting current property value

 bBlockRepaint = _ObjectGetProperty(hPen, "BlockRepaint");

 // Setting Property 

	_ObjectSetProperty(hPen, "BlockRepaint", -1);

END