ObjectDCL Banner

FlushGraphicButtons Method

Description

This method  is intended to force all GraphicButtons to repaint themselves.   This method is useful when controlling transparency of GraphicButtons. This method is intended to be called after the GraphicButton(s) has first been hidden, then reshown.

Parameters

MyDialogReference
Reference to the dialog.
ProjectFile
String identifying the project as it was passed in LoadProject.
DialogName
String identifying the dialog by name.

Return Values

Returns the following according to the situation:

  • T when successful.
  • Nil if the dialog is not found.

AutoLISP Syntax

The recommended convention is passing the control identifier directly:

CopyCode imageCopy Code
(Odcl_FlushGraphicButtons 
		MyDialogReference [as Reference]
	)

An alternative convention is to identify the control by providing the project file, the dialog name and the control name:

CopyCode imageCopy Code
(Odcl_FlushGraphicButtons
		ProjectFile [as String]
		DialogName [as String]
	)

Applies For

GraphicButton.

Example

CopyCode imageCopy Code
; Flush all the graphic buttons of my form
(Odcl_Control_SetProperty MyProject_MyForm_MyGraphicButton "Visible" Nil)
(Odcl_Control_SetProperty MyProject_MyForm_MyGraphicButton "Visible" T)
(Odcl_FlushGraphicButtons MyProject_MyForm)