Share via

Control Settings, MFC Smart Device ActiveX Control Wizard

  • Article

Describes the Control Settings page of the MFC Smart Device ActiveX Control Wizard.

Use the options on this page to specify how you want your control to behave. For example, you can base your control on existing standard Windows CE control types, optimize the control's behavior and appearance, or indicate that the control can act as a container for other controls.

See MFC ActiveX Controls: Optimization for more information about selecting options on this page to maximize the efficiency of your control.

Create control based on

From the list, you can select the type of control from which your control should inherit. The list includes additional common controls exposed to your MFC application in commctrl.h. Your selection determines the style of the control in the PreCreateWindow function in the ProjNameCtrl.cpp file. See MFC ActiveX Controls: Subclassing a Windows Control for more information.

BUTTON

A button control

COMBOBOX

A combo box control

EDIT

An edit control

LISTBOX

A list box control

SCROLLBAR

A scroll bar control

STATIC

A static control

msctls_progress32

A progress bar common control

msctls_statusbar32

A status bar common control

msctls_trackbar32

A track bar common control

msctls_updown32

A spin button common control

SysHeader32

A header common control

SysListView32

A list view common control

SysTabControl32

A tab common control

SysTreeView32

A tree view common control

Additional features

  • Activates when visible
    Specifies that a window is created for the control when it becomes visible. The Activates when visible option is set by default. If you want to defer activating the control until the container needs it (for example, by a user's mouse click), uncheck this feature. Turning off this feature optimizes the control by not incurring the expense of creating a window until it is necessary. See Turning off the Activate When Visible Option for more information about this option.

  • Invisible at run time
    Specifies that the control has no user interface at runtime. A timer is a type of control you might want to be invisible.

  • Has an About box dialog
    Specifies that the control has the standard Windows CE About dialog box, displaying the version number and copyright information.

    Note

    How the user accesses help for the control depends on how you have implemented the help and whether you have integrated the control's help with the container's help. See HTML Help: Context-Sensitive Help for Your Programs for more information about integrating help.

    Setting this option inserts the AboutBox control method in the project's control class (CProjNameCtrl.cpp) and adds AboutBox to the project's Dispatch map. This option is set by default.

  • Optimized drawing code
    Specifies that the container restores the original GDI objects automatically after all the container's controls, which are drawn to the same device context, have been drawn. See Optimizing Control Drawing for more information about this feature.

  • Windowless activation
    Specifies that the control does not produce a window when it is activated. Windowless activation allows for nonrectangular or transparent controls, and windowless controls do not require the system overhead that a control with a window requires. A windowless control does not allow for an unclipped device context or flicker-free activation. Containers created before 1996 do not support windowless activation. See Providing Windowless Activation for more information on using this option.

  • Unclipped device context
    Overrides COleControl::GetControlFlags in the control header (projnamectrl.h) to disable the call to IntersectClipRect made by COleControl. Selecting Unclipped device context gains a small speed advantage. If you select Windowless activation, this feature is not available. See Using an Unclipped Device Context for more information.

  • Flicker-free activation
    Eliminates the drawing operations and their accompanying visual flicker that occur between the control's active and inactive states. If you select Windowless activation, this feature is not available. When you set this option, the noFlickerActivate flag is included in the flags returned by COleControl::GetControlFlags. See Providing Flicker-Free Activation for more information.

  • Available in Insert Object dialog
    Specifies that the control will be available in the Insert Object dialog box for enabled containers. When you select this option, the flag afxRegInsertable is included in the set of flags returned by AfxOleRegisterControlClass. The Insert Object dialog box allows the user to insert newly created or existing objects into a compound document.

  • Mouse pointer notifications when inactive
    Enables the control to process mouse pointer notifications, regardless whether control is active. When you select this option, the flag pointerInactive is included in the set of flags returned by COleControl::GetControlFlags. For more information about using this option, see Providing Mouse Interaction While Inactive.

  • Acts as a simple frame control
    Specifies that the control is a container for other controls by setting the OLEMISC_SIMPLEFRAME bit for the control. See Simple Frame Site Containment for more information.

  • Loads properties asynchronously
    Enables a reset of any previous asynchronous data and initiates a new load of the control's asynchronous property.

See Also

Reference

MFC Smart Device ActiveX Control Wizard