Skip to content

Latest commit

 

History

History
310 lines (237 loc) · 11.4 KB

ns-oledlg-oleuiinsertobjecta.md

File metadata and controls

310 lines (237 loc) · 11.4 KB
Raw
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name
NS:oledlg.tagOLEUIINSERTOBJECTA
OLEUIINSERTOBJECTA (oledlg.h)
Contains information that the OLE User Interface Library uses to initialize the Insert Object dialog box, and space for the library to return information when the dialog box is dismissed. (ANSI)
*LPOLEUIINSERTOBJECTA
*POLEUIINSERTOBJECTA
IOF_CHECKDISPLAYASICON
IOF_CHECKLINK
IOF_CREATEFILEOBJECT
IOF_CREATELINKOBJECT
IOF_CREATENEWOBJECT
IOF_DISABLEDISPLAYASICON
IOF_DISABLELINK
IOF_HIDECHANGEICON
IOF_SELECTCREATECONTROL
IOF_SELECTCREATEFROMFILE
IOF_SELECTCREATENEW
IOF_SHOWHELP
IOF_SHOWINSERTCONTROL
IOF_VERIFYSERVERSEXIST
LPOLEUIINSERTOBJECT
LPOLEUIINSERTOBJECT structure pointer [COM]
OLEUIINSERTOBJECT
OLEUIINSERTOBJECT structure [COM]
OLEUIINSERTOBJECTA
OLEUIINSERTOBJECTW
POLEUIINSERTOBJECT
POLEUIINSERTOBJECT structure pointer [COM]
_ole_OLEUIINSERTOBJECT_str
com.oleuiinsertobject_struct
oledlg/LPOLEUIINSERTOBJECT
oledlg/OLEUIINSERTOBJECT
oledlg/OLEUIINSERTOBJECTA
oledlg/OLEUIINSERTOBJECTW
oledlg/POLEUIINSERTOBJECT
com\oleuiinsertobject_struct.htm
com
b14df159-ed62-4745-8cac-c31364d0de7b
12/05/2018
*LPOLEUIINSERTOBJECTA, *POLEUIINSERTOBJECTA, IOF_CHECKDISPLAYASICON, IOF_CHECKLINK, IOF_CREATEFILEOBJECT, IOF_CREATELINKOBJECT, IOF_CREATENEWOBJECT, IOF_DISABLEDISPLAYASICON, IOF_DISABLELINK, IOF_HIDECHANGEICON, IOF_SELECTCREATECONTROL, IOF_SELECTCREATEFROMFILE, IOF_SELECTCREATENEW, IOF_SHOWHELP, IOF_SHOWINSERTCONTROL, IOF_VERIFYSERVERSEXIST, LPOLEUIINSERTOBJECT, LPOLEUIINSERTOBJECT structure pointer [COM], OLEUIINSERTOBJECT, OLEUIINSERTOBJECT structure [COM], OLEUIINSERTOBJECTA, OLEUIINSERTOBJECTW, POLEUIINSERTOBJECT, POLEUIINSERTOBJECT structure pointer [COM], _ole_OLEUIINSERTOBJECT_str, com.oleuiinsertobject_struct, oledlg/LPOLEUIINSERTOBJECT, oledlg/OLEUIINSERTOBJECT, oledlg/OLEUIINSERTOBJECTA, oledlg/OLEUIINSERTOBJECTW, oledlg/POLEUIINSERTOBJECT
oledlg.h
Windows
Windows 2000 Professional [desktop apps only]
Windows 2000 Server [desktop apps only]
OLEUIINSERTOBJECTW (Unicode) and OLEUIINSERTOBJECTA (ANSI)
Windows
OLEUIINSERTOBJECTA, *POLEUIINSERTOBJECTA, *LPOLEUIINSERTOBJECTA
19H1
tagOLEUIINSERTOBJECTA
oledlg/tagOLEUIINSERTOBJECTA
POLEUIINSERTOBJECTA
oledlg/POLEUIINSERTOBJECTA
OLEUIINSERTOBJECTA
oledlg/OLEUIINSERTOBJECTA
c++
APIRef
kbSyntax
HeaderDef
OleDlg.h
OLEUIINSERTOBJECT
OLEUIINSERTOBJECTA
OLEUIINSERTOBJECTW

OLEUIINSERTOBJECTA structure

-description

Contains information that the OLE User Interface Library uses to initialize the Insert Object dialog box, and space for the library to return information when the dialog box is dismissed.

-struct-fields

-field cbStruct

The size of the structure, in bytes. This field must be filled on input.

-field dwFlags

On input, specifies the initialization and creation flags. On exit, specifies the user's choices. It can be a combination of the following flags.

Value Meaning
IOF_SHOWHELP
 The dialog box will display a Help button.
IOF_SELECTCREATENEW
 The Create New radio button will initially be checked. This cannot be used with IOF_SELECTCREATEFROMFILE.
IOF_SELECTCREATEFROMFILE
 The Create From File radio button will initially be checked. This cannot be used with IOF_SELECTCREATENEW.
IOF_CHECKLINK
 The Link check box will initially be checked.
IOF_CHECKDISPLAYASICON
 The Display As Icon check box will initially be checked, the current icon will be displayed, and the Change Icon button will be enabled.
IOF_CREATENEWOBJECT
 A new object should be created when the user selects OK to dismiss the dialog box and the Create New radio button was selected.
IOF_CREATEFILEOBJECT
 A new object should be created from the specified file when the user selects OK to dismiss the dialog box and the Create From File radio button was selected.
IOF_CREATELINKOBJECT
 A new linked object should be created when the user selects OK to dismiss the dialog box and the user checked the Link check box.
IOF_DISABLELINK
 The Link check box will be disabled on initialization.
IOF_VERIFYSERVERSEXIST
 The dialog box should validate the classes it adds to the listbox by ensuring that the server specified in the registration database exists. This is a significant performance factor.
IOF_DISABLEDISPLAYASICON
 The Display As Icon check box will be disabled on initialization.
IOF_HIDECHANGEICON
 The Change Icon button will be hidden in the Insert Object dialog box.
IOF_SHOWINSERTCONTROL
 Displays the Insert Control radio button.
IOF_SELECTCREATECONTROL
 Displays the Create Control radio button.

-field hWndOwner

The window that owns the dialog box. This member should not be NULL.

-field lpszCaption

Pointer to a string to be used as the title of the dialog box. If NULL, then the library uses Insert Object.

-field lpfnHook

Pointer to a hook function that processes messages intended for the dialog box. The hook function must return zero to pass a message that it didn't process back to the dialog box procedure in the library. The hook function must return a nonzero value to prevent the library's dialog box procedure from processing a message it has already processed.

-field lCustData

Application-defined data that the library passes to the hook function pointed to by the lpfnHook member. The library passes a pointer to the OLEUIINSERTOBJECT structure in the lParam parameter of the WM_INITDIALOG message; this pointer can be used to retrieve the lCustData member.

-field hInstance

Instance that contains a dialog box template specified by the lpTemplateName member.

-field lpszTemplate

Pointer to a null-terminated string that specifies the name of the resource file for the dialog box template that is to be substituted for the library's Insert Object dialog box template.

-field hResource

Customized template handle.

-field clsid

CLSID for class of the object to be inserted. Filled on output.

-field lpszFile

Pointer to the name of the file to be linked or embedded. Filled on output.

-field cchFile

Size of lpszFile buffer; will not exceed MAX_PATH.

-field cClsidExclude

Number of CLSIDs included in the lpClsidExclude list. Filled on input.

-field lpClsidExclude

Pointer to a list of CLSIDs to exclude from listing.

-field iid

Identifier of the requested interface. If OleUIInsertObject creates the object, then it will return a pointer to this interface. This parameter is ignored if OleUIInsertObject does not create the object.

-field oleRender

Rendering option. If OleUIInsertObject creates the object, then it selects the rendering option when it creates the object. This parameter is ignored if OleUIInsertObject does not create the object.

-field lpFormatEtc

Desired format. If OleUIInsertObject creates the object, then it selects the format when it creates the object. This parameter is ignored if OleUIInsertObject does not create the object.

-field lpIOleClientSite

Pointer to the client site to be used for the object. This parameter is ignored if OleUIInsertObject does not create the object.

-field lpIStorage

Pointer to the storage to be used for the object. This parameter is ignored if OleUIInsertObject does not create the object.

-field ppvObj

Address of output pointer variable that contains the interface pointer for the object being inserted. This parameter is ignored if OleUIInsertObject does not create the object.

-field sc

Result of creation calls. This parameter is ignored if OleUIInsertObject does not create the object.

-field hMetaPict

MetafilePict structure containing the iconic aspect, if it wasn't placed in the object's cache.

-see-also

OleUIInsertObject

-remarks

Note

The oledlg.h header defines OLEUIINSERTOBJECT as an alias which automatically selects the ANSI or Unicode version of this function based on the definition of the UNICODE preprocessor constant. Mixing usage of the encoding-neutral alias with code that not encoding-neutral can lead to mismatches that result in compilation or runtime errors. For more information, see Conventions for Function Prototypes.