COleControlSite Class
Provides support for custom client-side control interfaces.
Syntax
class COleControlSite : public CCmdTarget
Members
Public Constructors
| Name | Description |
|---|---|
| COleControlSite::COleControlSite | Constructs a COleControlSite object. |
Public Methods
| Name | Description |
|---|---|
| COleControlSite::BindDefaultProperty | Binds the default property of the hosted control to a data source. |
| COleControlSite::BindProperty | Binds a property of the hosted control to a data source. |
| COleControlSite::CreateControl | Creates a hosted ActiveX control. |
| COleControlSite::DestroyControl | Destroys the hosted control. |
| COleControlSite::DoVerb | Executes a specific verb of the hosted control. |
| COleControlSite::EnableDSC | Enables data sourcing for a control site. |
| COleControlSite::EnableWindow | Enables the control site. |
| COleControlSite::FreezeEvents | Specifies if the control site is accepting events. |
| COleControlSite::GetDefBtnCode | Retrieves the default button code for the hosted control. |
| COleControlSite::GetDlgCtrlID | Retrieves the identifier of the control. |
| COleControlSite::GetEventIID | Retrieves the ID of an event interface for a hosted control. |
| COleControlSite::GetExStyle | Retrieves the extended styles of the control site. |
| COleControlSite::GetProperty | Retrieves a specific property of the hosted control. |
| COleControlSite::GetStyle | Retrieves the styles of the control site. |
| COleControlSite::GetWindowText | Retrieves the text of the hosted control. |
| COleControlSite::InvokeHelper | Invoke a specific method of the hosted control. |
| COleControlSite::InvokeHelperV | Invoke a specific method of the hosted control with a variable list of arguments. |
| COleControlSite::IsDefaultButton | Determines if the control is the default button in the window. |
| COleControlSite::IsWindowEnabled | Checks the visible state of the control site. |
| COleControlSite::ModifyStyle | Modifies the current extended styles of the control site. |
| COleControlSite::ModifyStyleEx | Modifies the current styles of the control site. |
| COleControlSite::MoveWindow | Changes the position of the control site. |
| COleControlSite::QuickActivate | Quick activates the hosted control. |
| COleControlSite::SafeSetProperty | Sets a property or method of the control without chance of throwing an exception. |
| COleControlSite::SetDefaultButton | Sets the default button in the window. |
| COleControlSite::SetDlgCtrlID | Retrieves the identifier of the control. |
| COleControlSite::SetFocus | Sets the focus to the control site. |
| COleControlSite::SetProperty | Sets a specific property of the hosted control. |
| COleControlSite::SetPropertyV | Sets a specific property of the hosted control with a variable list of arguments. |
| COleControlSite::SetWindowPos | Sets the position of the control site. |
| COleControlSite::SetWindowText | Sets the text of the hosted control. |
| COleControlSite::ShowWindow | Shows or hides the control site. |
Protected Methods
| Name | Description |
|---|---|
| COleControlSite::GetControlInfo | Retrieves keyboard information and mnemonics for the hosted control. |
Public Data Members
| Name | Description |
|---|---|
| COleControlSite::m_bIsWindowless | Determines if the hosted control is a windowless control. |
| COleControlSite::m_ctlInfo | Contains information on keyboard handling for the control. |
| COleControlSite::m_dwEventSink | The cookie of the control's connection point. |
| COleControlSite::m_dwMiscStatus | The miscellaneous states for the hosted control. |
| COleControlSite::m_dwPropNotifySink | The IPropertyNotifySink cookie of the control. |
| COleControlSite::m_dwStyle | The styles of the hosted control. |
| COleControlSite::m_hWnd | The handle of the control site. |
| COleControlSite::m_iidEvents | The ID of the event interface for the hosted control. |
| COleControlSite::m_nID | The ID of the hosted control. |
| COleControlSite::m_pActiveObject | A pointer to the IOleInPlaceActiveObject object of the hosted control. |
| COleControlSite::m_pCtrlCont | The container of the hosted control. |
| COleControlSite::m_pInPlaceObject | A pointer to the IOleInPlaceObject object of the hosted control. |
| COleControlSite::m_pObject | A pointer to the IOleObjectInterface interface of the control. |
| COleControlSite::m_pWindowlessObject | A pointer to the IOleInPlaceObjectWindowless interface of the control. |
| COleControlSite::m_pWndCtrl | A pointer to the window object for the hosted control. |
| COleControlSite::m_rect | The dimensions of the control site. |
Remarks
This support is the primary means by which an embedded ActiveX control obtains information about the location and extent of its display site, its moniker, its user interface, its ambient properties, and other resources provided by its container. COleControlSite fully implements the IOleControlSite, IOleInPlaceSite, IOleClientSite, IPropertyNotifySink, IBoundObjectSite, INotifyDBEvents, IRowSetNotify interfaces. In addition, the IDispatch interface (providing support for ambient properties and event sinks) is also implemented.
To create an ActiveX control site using COleControlSite, derive a class from COleControlSite. In your CWnd-derived class for the container (for instance, your dialog box) override the CWnd::CreateControlSite function.
Inheritance Hierarchy
COleControlSite
Requirements
Header: afxocc.h
COleControlSite::BindDefaultProperty
Binds the calling object's default simple bound property, as marked in the type library, to the underlying cursor that is defined by the DataSource, UserName, Password, and SQL properties of the data-source control.
virtual void BindDefaultProperty(
DISPID dwDispID,
VARTYPE vtProp,
LPCTSTR szFieldName,
CWnd* pDSCWnd);
Parameters
dwDispID
Specifies the DISPID of a property on a data-bound control that is to be bound to a data-source control.
vtProp
Specifies the type of the property to be bound — for example, VT_BSTR, VT_VARIANT, and so on.
szFieldName
Specifies the name of the column, in the cursor provided by the data-source control, to which the property will be bound.
pDSCWnd
A pointer to the CWnd-derived object that hosts the data-source control to which the property will be bound.
Remarks
The CWnd object on which you call this function must be a data-bound control.
COleControlSite::BindProperty
Binds the calling object's simple bound property, as marked in the type library, to the underlying cursor that is defined by the DataSource, UserName, Password, and SQL properties of the data-source control.
virtual void BindProperty(
DISPID dwDispId,
CWnd* pWndDSC);
Parameters
dwDispId
Specifies the DISPID of a property on a data-bound control that is to be bound to a data-source control.
pWndDSC
A pointer to the CWnd-derived object that hosts the data-source control to which the property will be bound.
Remarks
The CWnd object on which you call this function must be a data-bound control.
COleControlSite::COleControlSite
Constructs a new COleControlSite object.
explicit COleControlSite(COleControlContainer* pCtrlCont);
Parameters
pCtrlCont
A pointer to the control's container (which represents the window that hosts the AtiveX control).
Remarks
This function is called by the COccManager::CreateContainer function. For more information on customizing the creation of containers, see COccManager::CreateSite.
COleControlSite::CreateControl
Creates an ActiveX control, hosted by the COleControlSite object.
virtual HRESULT CreateControl(
CWnd* pWndCtrl,
REFCLSID clsid,
LPCTSTR lpszWindowName,
DWORD dwStyle,
const RECT& rect,
UINT nID,
CFile* pPersist = NULL,
BOOL bStorage = FALSE,
BSTR bstrLicKey = NULL);
virtual HRESULT CreateControl(
CWnd* pWndCtrl,
REFCLSID clsid,
LPCTSTR lpszWindowName,
DWORD dwStyle,
const POINT* ppt,
const SIZE* psize,
UINT nID,
CFile* pPersist = NULL,
BOOL bStorage = FALSE,
BSTR bstrLicKey = NULL);
Parameters
pWndCtrl
A pointer to the window object representing the control.
clsid
The unique class ID of the control.
lpszWindowName
A pointer to the text to be displayed in the control. Sets the value of the winodw's Caption or Text property (if any).
dwStyle
Windows styles. The available styles are listed under the Remarks section.
rect
Specifies the control's size and position. It can be either a CRect object or a RECT structure.
nID
Specifies the control's child window ID.
pPersist
A pointer to a CFile containing the persistent state for the control. The default value is NULL, indicating that the control initializes itself without restoring its state from any persistent storage. If not NULL, it should be a pointer to a CFile-derived object that contains the control's persistent data, in the form of either a stream or a storage. This data could have been saved in a previous activation of the client. The CFile can contain other data, but must have its read-write pointer set to the first byte of persistent data at the time of the call to CreateControl.
bStorage
Indicates whether the data in pPersist should be interpreted as IStorage or IStream data. If the data in pPersist is a storage, bStorage should be TRUE. If the data in pPersist is a stream, bStorage should be FALSE. The default value is FALSE.
bstrLicKey
Optional license key data. This data is needed only for creating controls that require a run-time license key. If the control supports licensing, you must provide a license key for the creation of the control to succeed. The default value is NULL.
ppt
A pointer to a POINT structure that contains the upper-left corner of the control. The size of the control is determined by the value of psize. The ppt and psize values are an optional method of specifying the size and position opf the control.
psize
A pointer to a SIZE structure that contains the size of the control. The upper-left corner is determined by the value of ppt. The ppt and psize values are an optional method of specifying the size and position opf the control.
Return Value
A standard HRESULT value.
Remarks
Only a subset of the Windows dwStyle flags are supported by CreateControl:
WS_VISIBLE Creates a window that is initially visible. Required if you want the control to be visible immediately, like ordinary windows.
WS_DISABLED Creates a window that is initially disabled. A disabled window cannot receive input from the user. Can be set if the control has an Enabled property.
WS_BORDER Creates a window with a thin-line border. Can be set if control has a BorderStyle property.
WS_GROUP Specifies the first control of a group of controls. The user can change the keyboard focus from one control in the group to the next by using the direction keys. All controls defined with the WS_GROUP style after the first control belong to the same group. The next control with the WS_GROUP style ends the group and starts the next group.
WS_TABSTOP Specifies a control that can receive the keyboard focus when the user presses the TAB key. Pressing the TAB key changes the keyboard focus to the next control of the WS_TABSTOP style.
Use the second overload to create default-sized controls.
COleControlSite::DestroyControl
Destroys the COleControlSite object.
virtual BOOL DestroyControl();
Return Value
Nonzero if successful, otherwise 0.
Remarks
Once completed, the object is freed from memory and any pointers to the object are no longer valid.
COleControlSite::DoVerb
Executes the specified verb.
virtual HRESULT DoVerb(
LONG nVerb,
LPMSG lpMsg = NULL);
Parameters
nVerb
Specifies the verb to execute. It can include one of the following:
| Value | Meaning | Symbol |
|---|---|---|
| 0 | Primary verb | OLEIVERB_PRIMARY |
| -1 | Secondary verb | (None) |
| 1 | Displays the object for editing. | OLEIVERB_SHOW |
| -2 | Edits the item in a separate window. | OLEIVERB_OPEN |
| -3 | Hides the object. | OLEIVERB_HIDE |
| -4 | Activates a control in-place. | OLEIVERB_UIACTIVATE |
| -5 | Activates a control in-place, without additional user interface elements. | OLEIVERB_INPLACEACTIVATE |
| -7 | Display the control's properties. | OLEIVERB_PROPERTIES |
lpMsg
Pointer to the message that caused the item to be activated.
Return Value
A standard HRESULT value.
Remarks
This function directly calls through the control's IOleObject interface to execute the specified verb. If an exception is thrown as a result of this function call, an HRESULT error code is returned.
For more information, see IOleObject::DoVerb in the Windows SDK.
COleControlSite::EnableDSC
Enables data sourcing for the control site.
virtual void EnableDSC();
Remarks
Called by the framework to enable and initialize data sourcing for the control site. Override this function to provide customized behavior.
COleControlSite::EnableWindow
Enables or disables mouse and keyboard input to the control site.
virtual BOOL EnableWindow(BOOL bEnable);
Parameters
bEnable
Specifies whether to enable or disable the window: TRUE if window input is to be enabled, otherwise FALSE.
Return Value
Nonzero if the window was previously disabled, otherwise 0.
COleControlSite::FreezeEvents
Specifies whether the control site will handle or ignore events fired from a control.
void FreezeEvents(BOOL bFreeze);
Parameters
bFreeze
Specifies whether the control site wishes to stop accepting events. Nonzero if the control is not accepting events; otherwise zero.
Remarks
If bFreeze is TRUE, the control site requests the control to stop firing events. If bFreeze is FALSE, the control site requests the control to continue firing events.
Note
The control is not required to stop firing events if requested by the control site. It can continue firing but all subsequent events will be ignored by the control site.
COleControlSite::GetControlInfo
Retrieves information about a control's keyboard mnemonics and keyboard behavior.
void GetControlInfo();
Remarks
The information is stored in COleControlSite::m_ctlInfo.
COleControlSite::GetDefBtnCode
Determines if the control is a default push button.
DWORD GetDefBtnCode();
Return Value
Can be one of the following values:
DLGC_DEFPUSHBUTTON Control is the default button in the dialog.
DLGC_UNDEFPUSHBUTTON Control is not the default button in the dialog.
0 Control is not a button.
COleControlSite::GetDlgCtrlID
Retrieves the identifier of the control.
virtual int GetDlgCtrlID() const;
Return Value
The dialog item identifier of the control.
COleControlSite::GetEventIID
Retrieves a pointer to the control's default event interface.
BOOL GetEventIID(IID* piid);
Parameters
piid
A pointer to an interface ID.
Return Value
Nonzero if successful, otherwise 0. If successful, piid contains the interface ID for the control's default event interface.
COleControlSite::GetExStyle
Retrieves the window's extended styles.
virtual DWORD GetExStyle() const;
Return Value
The control window's extended styles.
Remarks
To retrieve the regular styles, call COleControlSite::GetStyle.
COleControlSite::GetProperty
Gets the control property specified by dwDispID.
virtual void GetProperty(
DISPID dwDispID,
VARTYPE vtProp,
void* pvProp) const;
Parameters
dwDispID
Identifies the dispatch ID of the property, found on the control's default IDispatch interface, to be retrieved.
vtProp
Specifies the type of the property to be retrieved. For possible values, see the Remarks section for COleDispatchDriver::InvokeHelper.
pvProp
Address of the variable that will receive the property value. It must match the type specified by vtProp.
Remarks
The value is returned through pvProp.
COleControlSite::GetStyle
Retrieves the styles of the control site.
virtual DWORD GetStyle() const;
Return Value
The window's styles.
Remarks
For a list of possible values, see Windows Styles. To retrieve the extended styles of the control site, call COleControlSite::GetExStyle.
COleControlSite::GetWindowText
Retrieves the current text of the control.
virtual void GetWindowText(CString& str) const;
Parameters
str
A reference to a CString object that contains the current text of the control.
Remarks
If the control supports the Caption stock property, this value is returned. If the Caption stock property is not supported, the value for the Text property is returned.
COleControlSite::InvokeHelper
Invokes the method or property specified by dwDispID, in the context specified by wFlags.
virtual void AFX_CDECL InvokeHelper(
DISPID dwDispID,
WORD wFlags,
VARTYPE vtRet,
void* pvRet,
const BYTE* pbParamInfo, ...);
Parameters
dwDispID
Identifies the dispatch ID of the property or method, found on the control's IDispatch interface, to be invoked.
wFlags
Flags describing the context of the call to IDispatch::Invoke. For possible wFlags values, see IDispatch::Invoke in the Windows SDK.
vtRet
Specifies the type of the return value. For possible values, see the Remarks section for COleDispatchDriver::InvokeHelper.
pvRet
Address of the variable that will receive the property value or return value. It must match the type specified by vtRet.
pbParamInfo
Pointer to a null-terminated string of bytes specifying the types of the parameters following pbParamInfo. For possible values, see the Remarks section for COleDispatchDriver::InvokeHelper.
...
Variable list of parameters, of types specified in pbParamInfo.
Remarks
The pbParamInfo parameter specifies the types of the parameters passed to the method or property. The variable list of arguments is represented by ... in the syntax declaration.
This function converts the parameters to VARIANTARG values, then invokes the IDispatch::Invoke method on the control. If the call to IDispatch::Invoke fails, this function will throw an exception. If the status code returned by IDispatch::Invoke is DISP_E_EXCEPTION, this function throws a COleDispatchException object, otherwise it throws a COleException.
COleControlSite::InvokeHelperV
Invokes the method or property specified by dwDispID, in the context specified by wFlags.
virtual void InvokeHelperV(
DISPID dwDispID,
WORD wFlags,
VARTYPE vtRet,
void* pvRet,
const BYTE* pbParamInfo,
va_list argList);
Parameters
dwDispID
Identifies the dispatch ID of the property or method, found on the control's IDispatch interface, to be invoked.
wFlags
Flags describing the context of the call to IDispatch::Invoke.
vtRet
Specifies the type of the return value. For possible values, see the Remarks section for COleDispatchDriver::InvokeHelper.
pvRet
Address of the variable that will receive the property value or return value. It must match the type specified by vtRet.
pbParamInfo
Pointer to a null-terminated string of bytes specifying the types of the parameters following pbParamInfo. For possible values, see the Remarks section for COleDispatchDriver::InvokeHelper.
argList
Pointer to a variable argument list.
Remarks
The pbParamInfo parameter specifies the types of the parameters passed to the method or property. Extra parameters for the method or property being invoked can be passed using the va_list parameter.
Typically, this function is called by COleControlSite::InvokeHelper.
COleControlSite::IsDefaultButton
Determines if the control is the default button.
BOOL IsDefaultButton();
Return Value
Nonzero if the control is the default button on the window, otherwise zero.
COleControlSite::IsWindowEnabled
Determines if the control site is enabled.
virtual BOOL IsWindowEnabled() const;
Return Value
Nonzero if the control is enabled, otherwise zero.
Remarks
The value is retrieved from the control's Enabled stock property.
COleControlSite::m_bIsWindowless
Determines if the object is a windowless control.
BOOL m_bIsWindowless;
Remarks
Nonzero if the control has no window, otherwise zero.
COleControlSite::m_ctlInfo
Information on how keyboard input is handled by the control.
CONTROLINFO m_ctlInfo;
Remarks
This information is stored in a CONTROLINFO structure.
COleControlSite::m_dwEventSink
Contains the connection point's cookie from the control's event sink.
DWORD m_dwEventSink;
COleControlSite::m_dwMiscStatus
Contains miscellaneous information about the control.
DWORD m_dwMiscStatus;
Remarks
For more information, see OLEMISCin the Windows SDK.
COleControlSite::m_dwPropNotifySink
Contains the IPropertyNotifySink cookie.
DWORD m_dwPropNotifySink;
COleControlSite::m_dwStyle
Contains the Window styles of the control.
DWORD m_dwStyle;
COleControlSite::m_hWnd
Contains the HWND of the control, or NULL if the control is windowless.
HWND m_hWnd;
COleControlSite::m_iidEvents
Contains the interface ID of the control's default event sink interface.
IID m_iidEvents;
COleControlSite::m_nID
Contains the control's dialog item ID.
UINT m_nID;
COleControlSite::m_pActiveObject
Contains the IOleInPlaceActiveObject interface of the control.
LPOLEINPLACEACTIVEOBJECT m_pActiveObject;
COleControlSite::m_pCtrlCont
Contains the control's container (representing the form).
COleControlContainer* m_pCtrlCont;
COleControlSite::m_pInPlaceObject
Contains the IOleInPlaceObject IOleInPlaceObject interface of the control.
LPOLEINPLACEOBJECT m_pInPlaceObject;
COleControlSite::m_pObject
Contains the IOleObjectInterface interface of the control.
LPOLEOBJECT m_pObject;
COleControlSite::m_pWindowlessObject
Contains the IOleInPlaceObjectWindowlessIOleInPlaceObjectWindowless interface of the control.
IOleInPlaceObjectWindowless* m_pWindowlessObject;
COleControlSite::m_pWndCtrl
Contains a pointer to the CWnd object that represents the control itself.
CWnd* m_pWndCtrl;
COleControlSite::m_rect
Contains the bounds of the control, relative to the container's window.
CRect m_rect;
COleControlSite::ModifyStyle
Modifies the styles of the control.
virtual BOOL ModifyStyle(
DWORD dwRemove,
DWORD dwAdd,
UINT nFlags);
Parameters
dwRemove
The styles to be removed from the current window styles.
dwAdd
The styles to be added from the current window styles.
nFlags
Window positioning flags. For a list of possible values, see the SetWindowPos function in the Windows SDK.
Return Value
Nonzero if the styles are changed, otherwise zero.
Remarks
The control's stock Enabled property will be modified to match the setting for WS_DISABLED. The control's stock Border Style property will be modified to match the requested setting for WS_BORDER. All other styles are applied directly to the control's window handle, if one is present.
Modifies the window styles of the control. Styles to be added or removed can be combined by using the bitwise OR (|) operator. See the CreateWindow function in the Windows SDK for information about the available window styles.
If nFlags is nonzero, ModifyStyle calls the Win32 function SetWindowPos, and redraws the window by combining nFlags with the following four flags:
SWP_NOSIZE Retains the current size.
SWP_NOMOVE Retains the current position.
SWP_NOZORDER Retains the current Z order.
SWP_NOACTIVATE Does not activate the window.
To modify a window's extended styles, call ModifyStyleEx.
COleControlSite::ModifyStyleEx
Modifies the extended styles of the control.
virtual BOOL ModifyStyleEx(
DWORD dwRemove,
DWORD dwAdd,
UINT nFlags);
Parameters
dwRemove
The extended styles to be removed from the current window styles.
dwAdd
The extended styles to be added from the current window styles.
nFlags
Window positioning flags. For a list of possible values, see the SetWindowPos function in the Windows SDK.
Return Value
Nonzero if the styles are changed, otherwise zero.
Remarks
The control's stock Appearance property will be modified to match the setting for WS_EX_CLIENTEDGE. All other extended window styles are applied directly to the control's window handle, if one is present.
Modifies the window extended styles of the control site object. Styles to be added or removed can be combined by using the bitwise OR (|) operator. See the CreateWindowEx function in the Windows SDK for information about the available window styles.
If nFlags is nonzero, ModifyStyleEx calls the Win32 function SetWindowPos, and redraws the window by combining nFlags with the following four flags:
SWP_NOSIZE Retains the current size.
SWP_NOMOVE Retains the current position.
SWP_NOZORDER Retains the current Z order.
SWP_NOACTIVATE Does not activate the window.
To modify a window's extended styles, call ModifyStyle.
COleControlSite::MoveWindow
Changes the position of the control.
virtual void MoveWindow(
int x,
int y,
int nWidth,
int nHeight);
Parameters
x
The new position of the left side of the window.
y
The new position of the top of the window.
nWidth
The new width of the window
nHeight
The new height of the window.
COleControlSite::QuickActivate
Quick activates the contained control.
virtual BOOL QuickActivate();
Return Value
Nonzero if the control site was activated, otherwise zero.
Remarks
This function should be called only if the user is overriding the creation process of the control.
The IPersist*::Load and IPersist*::InitNew methods should be called after quick activation occurs. The control should establish its connections to the container's sinks during quick activation. However, these connections are not live until IPersist*::Load or IPersist*::InitNew has been called.
COleControlSite::SafeSetProperty
Sets the control property specified by dwDispID.
virtual BOOL AFX_CDECL SafeSetProperty(
DISPID dwDispID,
VARTYPE vtProp, ...);
Parameters
dwDispID
Identifies the dispatch ID of the property or method, found on the control's IDispatch interface, to be set.
vtProp
Specifies the type of property to be set. For possible values, see the Remarks section for COleDispatchDriver::InvokeHelper.
...
A single parameter of the type specified by vtProp.
Return Value
Nonzero if successful; otherwise zero.
Remarks
Note
Unlike SetProperty and SetPropertyV, if an error is encountered (such as trying to set a nonexistent property), no exception is thrown.
COleControlSite::SetDefaultButton
Sets the control as the default button.
void SetDefaultButton(BOOL bDefault);
Parameters
bDefault
Nonzero if the control should become the default button; otherwise zero.
Remarks
Note
The control must have the OLEMISC_ACTSLIKEBUTTON status bit set.
COleControlSite::SetDlgCtrlID
Changes the value of the control's dialog item identifier.
virtual int SetDlgCtrlID(int nID);
Parameters
nID
The new identifier value.
Return Value
If successful, the previous dialog item identifier of the window; otherwise 0.
Remarks
COleControlSite::SetFocus
Sets focus to the control.
virtual CWnd* SetFocus();
virtual CWnd* SetFocus(LPMSG lpmsg);
Parameters
lpmsg
A pointer to a MSG structure. This structure contains the Windows message triggering the SetFocus request for the control contained in the current control site.
Return Value
A pointer to the window that previously had focus.
COleControlSite::SetProperty
Sets the control property specified by dwDispID.
virtual void AFX_CDECL SetProperty(
DISPID dwDispID,
VARTYPE vtProp, ...);
Parameters
dwDispID
Identifies the dispatch ID of the property or method, found on the control's IDispatch interface, to be set.
vtProp
Specifies the type of property to be set. For possible values, see the Remarks section for COleDispatchDriver::InvokeHelper.
...
A single parameter of the type specified by vtProp.
Remarks
If SetProperty encounters an error, an exception is thrown.
The type of exception is determined by the return value of the attempt to set the property or method. If the return value is DISP_E_EXCEPTION, a COleDispatchExcpetion is thrown; otherwise a COleException.
COleControlSite::SetPropertyV
Sets the control property specified by dwDispID.
virtual void SetPropertyV(
DISPID dwDispID,
VARTYPE vtProp,
va_list argList);
Parameters
dwDispID
Identifies the dispatch ID of the property or method, found on the control's IDispatch interface, to be set.
vtProp
Specifies the type of property to be set. For possible values, see the Remarks section for COleDispatchDriver::InvokeHelper.
argList
Pointer to the list of arguments.
Remarks
Extra parameters for the method or property being invoked can be passed using the arg_list parameter. If SetProperty encounters an error, an exception is thrown.
The type of exception is determined by the return value of the attempt to set the property or method. If the return value is DISP_E_EXCEPTION, a COleDispatchExcpetion is thrown; otherwise a COleException.
COleControlSite::SetWindowPos
Sets the size, position, and Z order of the control site.
virtual BOOL SetWindowPos(
const CWnd* pWndInsertAfter,
int x,
int y,
int cx,
int cy,
UINT nFlags);
Parameters
pWndInsertAfter
A pointer to the window.
x
The new position of the left side of the window.
y
The new position of the top of the window.
cx
The new width of the window
cy
The new height of the window.
nFlags
Specifies the window sizing and positioning flags. For possible values, see the Remarks section for SetWindowPos in the Windows SDK.
Return Value
Nonzero if successful, otherwise zero.
COleControlSite::SetWindowText
Sets the text for the control site.
virtual void SetWindowText(LPCTSTR lpszString);
Parameters
lpszString
Pointer to a null-terminated string to be used as the new title or control text.
Remarks
This function first attempts to set the Caption stock property. If the Caption stock property is not supported, the Text property is set instead.
COleControlSite::ShowWindow
Sets the window's show state.
virtual BOOL ShowWindow(int nCmdShow);
Parameters
nCmdShow
Specifies how the control site is to be shown. It must be one of the following values:
SW_HIDE Hides this window and passes activation to another window.
SW_MINIMIZE Minimizes the window and activates the top-level window in the system's list.
SW_RESTORE Activates and displays the window. If the window is minimized or maximized, Windows restores it to its original size and position.
SW_SHOW Activates the window and displays it in its current size and position.
SW_SHOWMAXIMIZED Activates the window and displays it as a maximized window.
SW_SHOWMINIMIZED Activates the window and displays it as an icon.
SW_SHOWMINNOACTIVE Displays the window as an icon. The window that is currently active remains active.
SW_SHOWNA Displays the window in its current state. The window that is currently active remains active.
SW_SHOWNOACTIVATE Displays the window in its most recent size and position. The window that is currently active remains active.
SW_SHOWNORMAL Activates and displays the window. If the window is minimized or maximized, Windows restores it to its original size and position.
Return Value
Nonzero if the window was previously visible; 0 if the window was previously hidden.