Estrutura OLEUICHANGESOURCEA (oledlg.h)
Contém informações usadas para inicializar a caixa de diálogo Alterar Fonte 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 tagOLEUICHANGESOURCEA {
DWORD cbStruct;
DWORD dwFlags;
HWND hWndOwner;
LPCSTR lpszCaption;
LPFNOLEUIHOOK lpfnHook;
LPARAM lCustData;
HINSTANCE hInstance;
LPCSTR lpszTemplate;
HRSRC hResource;
OPENFILENAMEA *lpOFN;
DWORD dwReserved1[4];
LPOLEUILINKCONTAINERA lpOleUILinkContainer;
DWORD dwLink;
LPSTR lpszDisplayName;
ULONG nFileLength;
LPSTR lpszFrom;
LPSTR lpszTo;
} OLEUICHANGESOURCEA, *POLEUICHANGESOURCEA, *LPOLEUICHANGESOURCEA;
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.
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 FOR NULL, a biblioteca usará Alterar Fonte.
lpfnHook
Ponteiro para uma função de gancho que processa mensagens destinadas à caixa de diálogo. A função hook 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 pela estrutura 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 de caixa de diálogo que deve ser substituído pelo modelo de 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 de caixa de diálogo Converter padrão ou, se for válido, o modelo chamado 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 Abrir ou Salvar como definidas pelo sistema.
dwReserved1[4]
Este membro está reservado.
lpOleUILinkContainer
Ponteiro para a implementação do contêiner da interface IOleUILinkContainer , 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 a ser alterada.
Comentários
Observação
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 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
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de