Sign in Join
FPDoc Onlineexperiment

TCustomComboBox.CanShowEmulatedTextHint function

Member of TCustomComboBoxprotectedIn unit StdCtrls

Indicates whether an emulated TextHint can be displayed for the control.

Declaration

pascal
function CanShowEmulatedTextHint: Boolean; virtual

Function result

True when emulated TextHints are used, and the control state allows the hint display.

Description

CanShowEmulatedTextHint is a Boolean function which indicates whether an emulated text hint can be displayed for the control. Emulated text hints are the fallback mechanism used when text hints are not natively supported for a platform / widgetset.

The return value is True when all of the following conditions are met:

  • A Handle has been allocated for the widgetset class instance.
  • Text hints are not natively supported as an LCL capability for the platform.
  • The ComponentState property does not contain csDesigning or csLoading.
  • TextHint is not an empty string value.
  • Text is an empty string value.
  • The control is not Focused.

CanShowEmulatedTextHint is called during execution of the InitializeWnd method, when the LM_KILLFOCUS window message is handled for the control, and when a new value is assigned to the TextHint property.

An experiment, built from development snapshots. Not the official Free Pascal or Lazarus documentation.