Rogue Wave Views Foundation Package API Reference Guide |
Rogue Wave Views Documentation Home |
Class that encapsulate a dialog to select an ActiveX. More...
#include <ilviews/windows/cbrowser.h>
Public Member Functions | |
IlvControlBrowser (IlvSystemView parent, const char *title=0) | |
Constructor. More... | |
~IlvControlBrowser () | |
Destructor. More... | |
void | setTitle (const char *title) |
Sets the title of the dialog. More... | |
const char * | show () |
Shows the dialog. More... | |
const char * | show (IlvPos x, IlvPos y) |
Shows the dialog at a specified position. More... | |
const char * | showToMouse (IlvDisplay *display, IlvDirection justification=IlvCenter, IlvPos dx=0, IlvPos dy=0, IlBoolean ensureInScreen=IlTrue) |
This function shows the dialog at a position relative to the position of mouse pointer. More... | |
const char * | showToScreen (IlvDisplay *display, IlvDirection justification=IlvCenter, IlvPos dx=0, IlvPos dy=0, IlBoolean ensureInScreen=IlTrue) |
This function shows the dialog at a position relative to the working space screen. More... | |
const char * | showToView (const IlvView *view, IlvDirection justification=IlvCenter, IlvPos dx=0, IlvPos dy=0, IlBoolean ensureInScreen=IlTrue) |
This function shows the dialog at a position relative to the position of the view given as parameter. More... | |
Class that encapsulate a dialog to select an ActiveX.
Library: ilvcom
IlvControlBrowser::IlvControlBrowser | ( | IlvSystemView | parent, |
const char * | title = 0 |
||
) |
Constructor.
This constructor initializes an ActiveX selector.
parent | The parent system view. |
title | The title of the dialog. |
IlvControlBrowser::~IlvControlBrowser | ( | ) |
Destructor.
The destructor releases the resources used by this object.
void IlvControlBrowser::setTitle | ( | const char * | title | ) |
Sets the title of the dialog.
title | The title of the dialog. |
const char* IlvControlBrowser::show | ( | ) |
Shows the dialog.
Cancel
or a pointer to a string that contains the CLSID of the control chosen by the user. This string is valid as long as the dialog is valid and one of theshow
was not called. Shows the dialog at a specified position.
x | The horizontal position of the dialog. |
y | The vertical position of the dialog. |
Cancel
or a pointer to a string that contains the CLSID of the control chosen by the user. This string is valid as long as the dialog is valid and one of theshow
was not called. const char* IlvControlBrowser::showToMouse | ( | IlvDisplay * | display, |
IlvDirection | justification = IlvCenter , |
||
IlvPos | dx = 0 , |
||
IlvPos | dy = 0 , |
||
IlBoolean | ensureInScreen = IlTrue |
||
) |
This function shows the dialog at a position relative to the position of mouse pointer.
This function is similar to the function IlvView::moveToMouse, except that it shows the dialog and returns the value chosen by the user.
The dialog is shown at the position so that the point indicated by the position of the pointing device, with an offset of dx
and dy
.
The parameter justification specifies the point in the dialog that must be shown at the mouse location:
display | A const pointer to an IlvDisplay. |
justification | An IlvDirection that gives how the position must be computed relatively to the view. |
dx | An IlvPos that gives the offset for the abscissa. |
dy | An IlvPos that gives the offset for the ordinate. |
ensureInScreen | An IlBoolean that indicates whether the dialog must be thoroughly inside the working space of the screen (if possible). |
Cancel
or a pointer to a string that contains the CLSID of the control chosen by the user. This string is valid as long as the dialog is valid and one of theshow
was not called. const char* IlvControlBrowser::showToScreen | ( | IlvDisplay * | display, |
IlvDirection | justification = IlvCenter , |
||
IlvPos | dx = 0 , |
||
IlvPos | dy = 0 , |
||
IlBoolean | ensureInScreen = IlTrue |
||
) |
This function shows the dialog at a position relative to the working space screen.
This function is similar to the function IlvView::moveToScreen, except that it shows the dialog and returns the value chosen by the user.
The dialog is shown at the position indicated by justification
, relative to the screen, with an offset of dx
and dy
.
Valid values for justification
are:
display | A const pointer to an IlvDisplay. |
justification | An IlvDirection that gives how the position must be computed relatively to the view. |
dx | An IlvPos that gives the offset for the abscissa. |
dy | An IlvPos that gives the offset for the ordinate. |
ensureInScreen | An IlBoolean that indicates whether the dialog must be thoroughly inside the working space of the screen (if possible). |
Cancel
or a pointer to a string that contains the CLSID of the control chosen by the user. This string is valid as long as the dialog is valid and one of theshow
was not called. const char* IlvControlBrowser::showToView | ( | const IlvView * | view, |
IlvDirection | justification = IlvCenter , |
||
IlvPos | dx = 0 , |
||
IlvPos | dy = 0 , |
||
IlBoolean | ensureInScreen = IlTrue |
||
) |
This function shows the dialog at a position relative to the position of the view given as parameter.
This function is similar to the function IlvView::moveToView, except that it shows the dialog and returns the value chosen by the user.
The dialog is shown at the position indicated by justification
, relative to the position and size of view
, that must be a top view, with an offset of dx
and dy
. These offset are relative to view
, that means, for example, that when the dialog is justified with IlvLeft, the offset dx
will be subtracted to the abscissa, and when the dialog is justified with IlvRight, the offset dx
will be added to the abscissa. The principle is the same for the offset dy
.
Valid values for justification are:
view
. view
. view
. view
. view
. view
. view
. view
. view
. view | A const pointer to an IlvView. This parameter references the view from which the position is computed. |
justification | An IlvDirection that gives how the position must be computed relatively to the view. |
dx | An IlvPos that gives the offset for the abscissa. |
dy | An IlvPos that gives the offset for the ordinate. |
ensureInScreen | An IlBoolean that indicates whether the dialog must be thoroughly inside the working space of the screen (if possible). |
Cancel
or a pointer to a string that contains the CLSID of the control chosen by the user. This string is valid as long as the dialog is valid and one of theshow
was not called. © Copyright 2016, Rogue Wave Software, Inc. All Rights Reserved.
Rogue Wave is a registered trademark of Rogue Wave Software, Inc. in the United States and other countries. All other trademarks are the property of their respective owners.