|
IOleObject::SetHostNames
Provides an object with the name of its container application and the compound
document in which it is embedded.
HRESULT SetHostNames(
LPCOLESTR szContainerApp,
| //Pointer to name of container application
| LPCOLESTR szContainerObj
| //Pointer to name of container document
| );
|
|
Parameters
szContainerApp
[in] Points to the name of the container application in which the object is
running.
szContainerObj
[in] Points to the name of the compound document that contains the object. If
you do not wish to display the name of the compound document, you can set this
parameter to NULL.
Return Value
S_OK
Window title information set successfully.
Comments
When a container initializes an embedded object, it calls this function to
inform the object of the names of both the container application and container
document. When the object is opened for editing, it displays these names in the
title bar of its window.
Notes to Callers
Call SetHostNames only for embedded objects, because for linked objects, the link source
supplies its own separate editing window and title bar information.
Notes to Implementors
An object's application of SetHostNames should include whatever modifications to its user interface may be
appropriate to an object's embedded state. Such modifications typically will include
adding and removing menu commands and altering the text displayed in the title bar
of the editing window.
The complete window title for an embedded object in an SDI container
application or an MDI application with a maximized child window should appear as follows:
<object application name> - <object short type> in <container document>
Otherwise, the title should be:
<object application name>  <container document>
The "object short type" refers to a form of an object's name short enough to
be displayed in full in a list box.
Since these identifying strings are not stored as part of the persistent state
of the object, IOleObject::SetHostNames must be called each time the object loads or runs.
See Also
IOleObject::GetUserType
| Last news from Greatis Software |
 |
|
Nostalgia .Net |
|
.Net is powerful, but not all-powerful, so sometimes we need to use Win32 API for our .Net applications. It's simple enough with Platform Invoke if you have Win32 skill, but we do not always have time to dig the ancient documentation, declare the special types that are compatible with Win32, find the values of the Win32's constants and so on. Nostalgia .Net offers several simple-to-use classes, and components that will allow you to forget about the headache of Win32 and just use the power of Win32 in your application the same way as you use the native. Net classes. More » |
| Recommended software for developers |
 |
|
Ultimate Pack |
|
Component pack for Delphi and C++ Builder that contains runtime form designer, runtime object inspector, print suite and much more for the very special price. More » |
 |
|
Form Designer .Net |
|
Unique runtime form design solution that allows to edit any form in .Net WinForms application at runtime with full source codes for only 300 euro! More » |
 |
|
Print Suite .Net |
|
Print Suite .Net is a set of components for easy printing texts, images and grids from your WinForms applications. Full C# source codes are available More » |
 |
|
Gradient Controls .Net |
|
Gradient Controls .Net offers controls with gradient background feature. Labels, panels and so on... Full C# source codes are available More » |
 |
|
Greatis iGrid |
|
iGrid plots drawing grid right over your desktop, so you can use it everywhere, with any drawing application without any special plugins for different graphic editors. More » |
All the contacts and projectsDmitry Vasiliev (just.dmitry)
Related LinksSoftware for Visual Studio .NET developers
Software for Delphi and C++ Builder developers
Software for Visual Basic 6 developers
Delphi Tips&Tricks
MegaDetailed.NET More Online Helps Win32 Programmer's Reference
Win32 Multimedia Programmer's Reference
OLE Programmer's Reference
Microsoft Windows Pen API Programmer's Reference
Microsoft Windows Sockets 2 Reference
Microsoft Windows Telephony API (TAPI) Programmer's Reference
Unix Manual Pages
|
