exradialmenu - faq

How do you find the control's help / documentation on your computer:

  • Open the Run dialog on your Windows, and type exg2antt.chm, to run the exg2antt's help file. By default, the setup installs the CHM file into your system folder, so you can open the control's help / documentation by typing the control's name followed by .chm extension in the Run dialog box.
  • Locate and Run the ExG2antt.chm shortcut from the component's folder.
  • For How-To questions, you can run the ExHelper.exe shortcut located in the component's folder.
  • For How-To questions, you can locate and run the HOWTODO.chm shortcut from the component's folder.

Frequently Asked Questions - General

Click the programming language you use for general questions:

How-To Questions

Click the programming language you use for how-to questions:

Exontrol Software - ExRadialMenu FAQ page

Frequently Asked Questions - ExRadialMenu Component

Listed below are the questions that we are asked quite often. Before you write us, be sure to check here. 

Are you looking for something?

Just press CTRL+F ( or select Edit\Find menu item ) and you have a dialog that will help you to locate the string that are you looking for.

Where can I find the control's release notes?

The control's release notes can be found on our web site, looking for the Release Notes column in the control's main page. Click here for direct link.

(1) Is it possible to make the control transparent? (layered window method, exLayerUpdateScreeen)

"I would like to put the control on a form, then make the form transparent so the control appears on the desktop."

The control support transparent form, or in other words, displaying the control's itself without its form behind. 

 The following screen shot shows the control on a transparent form:

 The following screen shot shows the control on an opaque form:

 

In order to make your eXRadialMenu control to display a popup/widget, ( no form behind or form transparent ), you need to use the following properties:

  • Float property of the control, specifies whether the control is shown as float. You can use the Float property on exRadialMenuFloat or exRadialMenuFloatTopmost, to display the control as float ( places the control above all non-topmost windows )

The setup installs the C:\Program Files\Exontrol\ExRadialMenu\Sample\VB\Float or C:\Program Files\Exontrol\ExRadialMenu\Sample\VC\Float that shows all these working.

(2) Is it possible to make the control transparent? (layered child-window method, exLayerUpdateParent)

The following screen shot shows the transparent-control on a form:

In order to make your eXRadialMenu library to display a transparent-control inside your form/dialog/window/child, you need to use the following properties:

  • LayerUpdate property of the control, indicates where the control's content is updated. By default, the LayerUpdate property property is exLayerUpdateControl, which indicates that the control's content is shown on the control itself ( no effect ). If the LayerUpdate property is exLayerUpdateParent, the control does not show its background on the form that hosts it.

  • You need to add <supportedOS Id="{4a2f28e3-53b9-4441-ba9c-d69d4a4a6e38}"/>, to your manifest file as follows. The transparent-eXRadialMenu as a child of your form, it is supported on Windows 8, and later.

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <assembly manifestVersion="1.0" xmlns="urn:schemas-microsoft-com:asm.v1" xmlns:asmv3="urn:schemas-microsoft-com:asm.v3">
    	<compatibility xmlns="urn:schemas-microsoft-com:compatibility.v1"> 
    		<application> 
    			<supportedOS Id="{4a2f28e3-53b9-4441-ba9c-d69d4a4a6e38}"/>
    		</application> 
    	</compatibility>
    </assembly>

The setup installs the  C:\Program Files\Exontrol\ExRadialMenu\Sample\VC\Widget-Child sample that shows all these working.

How can I move the control / form / dialog once the user clicks the control?

The control provides the AllowMoveOnFloat property allows moving the control to a new position, when the user clicks and drags it over the screen, while it is floating ( Float property is set to a non-zero value ).

The trick is sending the WM_NCLBUTTONDOWN message to the form/dialog/window that hosts the control, when the MouseDown event of the control occurs.

In VB, you need to use a snippet of code as follows:

Private Declare Function SendMessage Lib "user32" Alias "SendMessageA" (ByVal hwnd As Long, ByVal wMsg As Long, ByVal wParam As Long, lParam As Any) As Long

Private Sub RadialMenu1_MouseDown(Button As Integer, Shift As Integer, X As Single, Y As Single)
    SendMessage Me.hwnd, &HA1, 2, 0
End Sub

In C++, you can call:

::SendMessage( m_hWnd, WM_NCLBUTTONDOWN, HTCAPTION, NULL );

, when control's MouseDown event occurs, where the m_hWnd, is the handle of the dialog that hosts the eXRadialMenu control, WM_NCLBUTTONDOWN is defined as 0x00A1, and the HTCAPTION as 2.

How can I define a layered / semi-transparent window/form?

You can use directly the SetLayeredWindowAttributes API function, or you can use the eXTransparent component:

In VB, you can use a code like follows:

Private Declare Function SetLayeredWindowAttributes Lib "user32.dll" (ByVal hwnd As Long, ByVal
crKey As Long, ByVal bAlpha As Byte, ByVal dwFlags As Long) As Boolean  
Private Declare Function SetWindowLong Lib "user32" Alias "SetWindowLongA" (ByVal hwnd As Long,
ByVal nIndex As Long, ByVal dwNewLong As Long) As Long  
Private Declare Function GetWindowLong Lib "user32" Alias "GetWindowLongA" (ByVal hwnd As Long,
ByVal nIndex As Long) As Long  
Const LWA_ALPHA = 2  
Const GWL_EXSTYLE = (-20)  
Const WS_EX_LAYERED = &H80000  

Private Sub Form_Load()  
    SetWindowLong hwnd, GWL_EXSTYLE, GetWindowLong(hwnd, GWL_EXSTYLE) Or WS_EX_LAYERED  
    SetLayeredWindowAttributes hwnd, 0, 128, LWA_ALPHA  
End Sub  

I am running the ...\ExGauge sample and it shows empty when clicking the item?

The eXRadialMenu component supports hosting the eXGauge control into any item. The eXGauge / eXLayers library provides graphics capabilities to visually display and edit the amount, level, or contents of something. The view can show one or more layers, where each layer can display one or more transparent pictures, HTML captions which can be clipped, moved, rotated or combination of them, by dragging the mouse, rolling the mouse wheel, or using the keyboard. Using the eXGauge / eXLayers library you can can easily simulate any gauges, thermometers, meters, clocks, buttons, sliders, scales, knobs, dials, switches, progress, status, indicators, LEDs, and so on. By default, the setup of eXRadialMenu component installs the ExGauge sample, which shows how you can integrate the eXGauge component into the eXRadialMenu component. 

There are four requirements so you can integrate the eXGauge to eXRadialMenu component like listed bellow:

  1. The Version of the eXGauge component must be 13.0 or greater.
  2. The BrowseType property of the eXRadialMenu is exBrowseItemCustom
  3. The BrowseCustomType property is exRadialCustomGauge
  4. The BrowseCustom(exRadialCustomGaugeHandle) property is set to the hWnd property of the eXGauge component

If all these meet, you can integrate the eXGauge to any item of the eXRadialMenu component and your component should look as:

 

Copyright 1999-2017 Exontrol. All rights reserved.