Estrutura OLEUIINSERTOBJECTA (oledlg.h)

  • Artigo

Contém informações que a Biblioteca de Interface do Usuário OLE usa para inicializar a caixa de diálogo Inserir Objeto e o espaço para a biblioteca retornar informações quando a caixa de diálogo for ignorada.

Sintaxe

typedef struct tagOLEUIINSERTOBJECTA {
  DWORD           cbStruct;
  DWORD           dwFlags;
  HWND            hWndOwner;
  LPCSTR          lpszCaption;
  LPFNOLEUIHOOK   lpfnHook;
  LPARAM          lCustData;
  HINSTANCE       hInstance;
  LPCSTR          lpszTemplate;
  HRSRC           hResource;
  CLSID           clsid;
  LPSTR           lpszFile;
  UINT            cchFile;
  UINT            cClsidExclude;
  LPCLSID         lpClsidExclude;
  IID             iid;
  DWORD           oleRender;
  LPFORMATETC     lpFormatEtc;
  LPOLECLIENTSITE lpIOleClientSite;
  LPSTORAGE       lpIStorage;
  LPVOID          *ppvObj;
  SCODE           sc;
  HGLOBAL         hMetaPict;
} OLEUIINSERTOBJECTA, *POLEUIINSERTOBJECTA, *LPOLEUIINSERTOBJECTA;

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.

Valor Significado
IOF_SHOWHELP
 A caixa de diálogo exibirá um botão Ajuda .
IOF_SELECTCREATENEW
 Inicialmente, o botão de opção Criar Novo será verificado. Isso não pode ser usado com IOF_SELECTCREATEFROMFILE.
IOF_SELECTCREATEFROMFILE
 Inicialmente, o botão de opção Criar do Arquivo será verificado. Isso não pode ser usado com IOF_SELECTCREATENEW.
IOF_CHECKLINK
 A caixa Vincular marcar será marcada inicialmente.
IOF_CHECKDISPLAYASICON
 A caixa exibir como ícone marcar inicialmente será marcada, o ícone atual será exibido e o botão Alterar Ícone será habilitado.
IOF_CREATENEWOBJECT
 Um novo objeto deve ser criado quando o usuário seleciona OK para ignorar a caixa de diálogo e o botão de opção Criar Novo foi selecionado.
IOF_CREATEFILEOBJECT
 Um novo objeto deve ser criado a partir do arquivo especificado quando o usuário seleciona OK para ignorar a caixa de diálogo e o botão de opção Criar do Arquivo foi selecionado.
IOF_CREATELINKOBJECT
 Um novo objeto vinculado deve ser criado quando o usuário seleciona OK para ignorar a caixa de diálogo e o usuário marcou a caixa Vincular marcar.
IOF_DISABLELINK
 A caixa Vincular marcar será desabilitada na inicialização.
IOF_VERIFYSERVERSEXIST
 A caixa de diálogo deve validar as classes adicionadas à caixa de listagem, garantindo que o servidor especificado no banco de dados de registro exista. Esse é um fator de desempenho significativo.
IOF_DISABLEDISPLAYASICON
 A caixa marcar Ícone Exibir como será desabilitada na inicialização.
IOF_HIDECHANGEICON
 O botão Alterar Ícone ficará oculto na caixa de diálogo Inserir Objeto .
IOF_SHOWINSERTCONTROL
 Exibe o botão de opção Inserir Controle .
IOF_SELECTCREATECONTROL
 Exibe o botão de opção Criar Controle .

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 FOR 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 hook 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 lpfnHook . A biblioteca passa um ponteiro para a estrutura OLEUIINSERTOBJECT no parâmetro lParam da mensagem WM_INITDIALOG; esse ponteiro pode ser usado para recuperar o membro lCustData .

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 de caixa de diálogo que deve ser substituído pelo modelo de 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 ; não excederá MAX_PATH.

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 das 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.

Comentários

Observação

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 de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Cabeçalho oledlg.h

Confira também

Oleuiinsertobject