*suppressed-ocx-properties*

Applies to the Windows platform only.

This is a tentative global variable, as we are not sure how to best deal with this problem in general. This functionality is likely to change in the future.

The value of this variable is an association list mapping particular OCX control class names to some of their properties that CG will hide, because allowing the user to change their values is not a good idea. The main effect is that these properties will not appear in the inspector in the IDE.

When a CG widget is defined for an OCX control by calling def-cg-ocx-control, CG generally defines all of the control's properties, because CG does not know which ones are not actually useful or that do nothing or that are not a good idea to modify. When defining your own OCX controls, you will need to discover this from the widget manufacturer's documentation and through experimentation.

If you would like to hide some of the properties of OCX controls that you define, then you could push them onto this alist. Below is the initial value. This list exists primarily because we now provide a standard html-widget in CG, which on Windows uses the WebBrowser OCX control, and it has several properties that we wanted to hide from the user.

(defparameter *suppressed-ocx-properties*
  
  ;; Hide certain properties with which users could easily
  ;; shoot themselves in the foot.
  '(
    ("WebBrowser"
     
     ;; These are the position and size of the control within its
     ;; site, but we make it always fill the site window in CG.
     "HWND" "Left" "Top" "Width" "Height")
    
    ("Monthview" "hWnd")
    ("DTPicker" "hWnd")))

Copyright (c) 1998-2022, Franz Inc. Lafayette, CA., USA. All rights reserved.
This page was not revised from the 10.0 page.
Created 2019.8.20.