Estrutura OLEUICHANGESOURCEW (oledlg.h)

Artigo
11/20/2024

Contém informações usadas para inicializar a caixa de diálogo alterar o de origem padrão. Ele permite que o usuário modifique o destino ou a origem de um link. Isso pode simplesmente implicar a seleção de um nome de arquivo diferente para o link ou, possivelmente, alterar a referência de item dentro do arquivo, por exemplo, alterar o intervalo de destino de células dentro da planilha à qual o link está.

Sintaxe

typedef struct tagOLEUICHANGESOURCEW {
  DWORD                 cbStruct;
  DWORD                 dwFlags;
  HWND                  hWndOwner;
  LPCWSTR               lpszCaption;
  LPFNOLEUIHOOK         lpfnHook;
  LPARAM                lCustData;
  HINSTANCE             hInstance;
  LPCWSTR               lpszTemplate;
  HRSRC                 hResource;
  OPENFILENAMEW         *lpOFN;
  DWORD                 dwReserved1[4];
  LPOLEUILINKCONTAINERW lpOleUILinkContainer;
  DWORD                 dwLink;
  LPWSTR                lpszDisplayName;
  ULONG                 nFileLength;
  LPWSTR                lpszFrom;
  LPWSTR                lpszTo;
} OLEUICHANGESOURCEW, *POLEUICHANGESOURCEW, *LPOLEUICHANGESOURCEW;

Membros

cbStruct

O tamanho da estrutura, em bytes.

dwFlags

Na entrada, esse campo especifica os sinalizadores de inicialização e criação. Na saída, ele especifica as opções do usuário. Pode ser uma combinação dos sinalizadores a seguir.

Valor	Significado
CSF_SHOWHELP	Habilita ou mostra o botão Ajuda.
CSF_VALIDSOURCE	Indica que o link foi validado.
CSF_ONLYGETSOURCE	Desabilita a validação automática da origem do link quando o usuário pressiona OK. Se você especificar esse sinalizador, deverá validar a origem quando a caixa de diálogo retornar OK.

hWndOwner

A janela que possui a caixa de diálogo.

lpszCaption

Ponteiro para uma cadeia de caracteres a ser usada como o título da caixa de diálogo. Se NULL, a biblioteca usará alterarde origem.

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 pela estrutura de OLEUICHANGEICON 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 lpszTemplate. Esse membro será ignorado se o membro lpszTemplate for NULL ou inválido.

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 Converter da biblioteca.

hResource

Identificador de recurso para uma caixa de diálogo personalizada. Se esse membro for NULL, a biblioteca usará o modelo da caixa de diálogo Converter padrão ou, se for válido, o modelo nomeado pelo membro lpszTemplate.

lpOFN

Ponteiro para a estrutura OPENFILENAME , que contém informações usadas pelo sistema operacional para inicializar as caixas de diálogo Open ou Save As definidas pelo sistema.

dwReserved1[4]

Este membro é reservado.

lpOleUILinkContainer

Ponteiro para a implementação do contêiner da interface IOleUILinkContainer do , usada para validar a origem do link. A caixa de diálogo Editar Links usa isso para permitir que o contêiner manipule seus links.

dwLink

Identificador de link exclusivo definido pelo contêiner usado para validar fontes de link. Usado por lpOleUILinkContainer.

lpszDisplayName

Ponteiro para o nome de exibição de origem completo.

nFileLength

Parte do moniker de arquivo de lpszDisplayName.

lpszFrom

Ponteiro para o prefixo da origem da qual foi alterado.

lpszTo

Ponteiro para o prefixo da origem para a qual será alterado.

Observações

Nota

O cabeçalho oledlg.h define OLEUICHANGESOURCE 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

Consulte também

IOleUILinkContainer

OleUIChangeSource

Compartilhar via