Estrutura OLEUIINSERTOBJECTW (oledlg.h)
Contém informações que a Biblioteca de Interface do Usuário OLE usa para inicializar a caixa de diálogo Inserir Objeto e espaço para a biblioteca retornar informações quando a caixa de diálogo for descartada.
Sintaxe
typedef struct tagOLEUIINSERTOBJECTW {
DWORD cbStruct;
DWORD dwFlags;
HWND hWndOwner;
LPCWSTR lpszCaption;
LPFNOLEUIHOOK lpfnHook;
LPARAM lCustData;
HINSTANCE hInstance;
LPCWSTR lpszTemplate;
HRSRC hResource;
CLSID clsid;
LPWSTR lpszFile;
UINT cchFile;
UINT cClsidExclude;
LPCLSID lpClsidExclude;
IID iid;
DWORD oleRender;
LPFORMATETC lpFormatEtc;
LPOLECLIENTSITE lpIOleClientSite;
LPSTORAGE lpIStorage;
LPVOID *ppvObj;
SCODE sc;
HGLOBAL hMetaPict;
} OLEUIINSERTOBJECTW, *POLEUIINSERTOBJECTW, *LPOLEUIINSERTOBJECTW;
Membros
cbStruct
O tamanho da estrutura, em bytes. Esse campo deve ser preenchido na entrada.
dwFlags
Na entrada, especifica os sinalizadores de inicialização e criação. Ao sair, especifica as opções do usuário. Pode ser uma combinação dos sinalizadores a seguir.
hWndOwner
A janela que possui a caixa de diálogo. Esse membro não deve ser NULL.
lpszCaption
Ponteiro para uma cadeia de caracteres a ser usada como o título da caixa de diálogo. Se NULL, a biblioteca usará Inserir Objeto.
lpfnHook
Ponteiro para uma função de gancho que processa mensagens destinadas à caixa de diálogo. A função de gancho deve retornar zero para passar uma mensagem informando que ela não foi processada novamente para o procedimento da caixa de diálogo na biblioteca. A função de gancho deve retornar um valor diferente de zero para impedir que o procedimento da caixa de diálogo da biblioteca processe uma mensagem que já foi processada.
lCustData
Dados definidos pelo aplicativo que a biblioteca passa para a função de gancho apontada pelo membro
hInstance
Instância que contém um modelo de caixa de diálogo especificado pelo membro lpTemplateName.
lpszTemplate
Ponteiro para uma cadeia de caracteres terminada em nulo que especifica o nome do arquivo de recurso para o modelo da caixa de diálogo que deve ser substituído pelo modelo da caixa de diálogo Inserir Objeto da biblioteca.
hResource
Identificador de modelo personalizado.
clsid
CLSID para a classe do objeto a ser inserido. Preenchido na saída.
lpszFile
Ponteiro para o nome do arquivo a ser vinculado ou inserido. Preenchido na saída.
cchFile
Tamanho do buffer lpszFile
cClsidExclude
Número de CLSIDs incluídos na lista lpClsidExclude. Preenchido na entrada.
lpClsidExclude
Ponteiro para uma lista de CLSIDs a serem excluídos da listagem.
iid
Identificador da interface solicitada. Se OleUIInsertObject criar o objeto, ele retornará um ponteiro para essa interface. Esse parâmetro será ignorado se OleUIInsertObject não criar o objeto.
oleRender
Opção de renderização. Se OleUIInsertObject criar o objeto, ele selecionará a opção de renderização ao criar o objeto. Esse parâmetro será ignorado se OleUIInsertObject não criar o objeto.
lpFormatEtc
Formato desejado. Se OleUIInsertObject criar o objeto, ele selecionará o formato quando ele criar o objeto. Esse parâmetro será ignorado se OleUIInsertObject não criar o objeto.
lpIOleClientSite
Ponteiro para o site cliente a ser usado para o objeto. Esse parâmetro será ignorado se OleUIInsertObject não criar o objeto.
lpIStorage
Ponteiro para o armazenamento a ser usado para o objeto. Esse parâmetro será ignorado se OleUIInsertObject não criar o objeto.
ppvObj
Endereço da variável de ponteiro de saída que contém o ponteiro de interface para o objeto que está sendo inserido. Esse parâmetro será ignorado se OleUIInsertObject não criar o objeto.
sc
Resultado de chamadas de criação. Esse parâmetro será ignorado se OleUIInsertObject não criar o objeto.
hMetaPict
Estrutura MetafilePict que contém o aspecto icônico, se não foi colocada no cache do objeto.
Observações
Nota
O cabeçalho oledlg.h define OLEUIINSERTOBJECT como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.
Requisitos
Requisito | Valor |
---|---|
de cliente com suporte mínimo | Windows 2000 Professional [somente aplicativos da área de trabalho] |
servidor com suporte mínimo | Windows 2000 Server [somente aplicativos da área de trabalho] |
cabeçalho | oledlg.h |