xlfCaller
Aplica-se a: Excel 2013 | Office 2013 | Visual Studio
Retorna informações sobre a célula, intervalo de células, comando em um menu, ferramenta em uma barra de ferramentas ou objeto que chamou o comando DLL ou função que está em execução no momento.
| Código chamado de | Retorna |
|---|---|
| DLL |
A ID do Registro. |
| Uma única célula |
Uma referência de célula única. |
| Uma fórmula de matriz de várias células |
Uma referência de várias células. |
| Uma expressão de formatação condicional |
Uma referência à célula à qual a condição de formatação é aplicada. |
| Um menu |
Uma matriz de linha única de quatro elementos: A ID da barra. A posição do menu. A posição de submenu. A posição de comando. |
| Uma barra de ferramentas |
Uma matriz de linha única de dois elementos: O número da barra de ferramentas para barras de ferramentas internas ou o nome da barra de ferramentas para barras de ferramentas personalizadas. A posição na barra de ferramentas. |
| Um objeto gráfico |
O identificador de objeto (nome do objeto). |
| Um comando associado a um xlcOnEnter, ON. ENTER, armadilha de eventos |
Uma referência à célula ou células que estão sendo inseridas. |
| Um comando associado a um xlcOnDoubleclick, ON. DOUBLECLICK, armadilha de eventos. | A célula que foi clicada duas vezes (não necessariamente a célula ativa). |
| Auto_Open, AutoClose, Auto_Activate ou macro Auto_Deactivate |
O nome da planilha de chamadas. |
| Outros métodos não listados |
#REF! Erro |
Excel12(xlfCaller, (LPXLOPER12) pxRes,0);
Valor de propriedade/Valor de retorno
O valor retornado é um dos seguintes tipos de dadosXLOPER12XLOPER/ : xltypeRef, xltypeSRef, xltypeNum, xltypeStr, xltypeErr ou xltypeMulti. Como três desses tipos apontam para a memória alocada, o valor retornado do xlfCaller deve ser sempre liberado em uma chamada para a função xlFree quando ela não for mais necessária.
Para obter mais informações sobre XLOPERs/ XLOPER12s , consulte Gerenciamento de Memória no Excel.
Comentários
Essa função é a única função que não é de planilha que pode ser chamada de uma função de planilha DLL/XLL. Outras funções de informações XLM só podem ser chamadas de comandos ou funções equivalentes de planilha de macro.
Exemplo
\SAMPLES\EXAMPLE\EXAMPLE.C. Essa função chama uma macro de comando (xlcSelect) e funcionará corretamente somente quando chamada de uma planilha de macro.
short WINAPI CallerExample(void)
{
XLOPER12 xRes;
Excel12(xlfCaller, &xRes, 0);
Excel12(xlcSelect, 0, 1, (LPXLOPER12)&xRes);
Excel12(xlFree, 0, 1, (LPXLOPER12)&xRes);
return 1;
}