Exemplo: A caixa de diálogo Abrir

O exemplo Shapes que temos vindo a utilizar é algo inventado. Vamos voltar para um objeto COM que você pode usar em um programa real do Windows: a caixa de diálogo Abrir .

Para mostrar a caixa de diálogo Abrir , um programa pode usar um objeto COM chamado objeto Common Item Dialog. A caixa de diálogo Common Item implementa uma interface chamada IFileOpenDialog, que é declarada no arquivo de cabeçalho Shobjidl.h.

Aqui está um programa que exibe a caixa de diálogo Abrir para o usuário. Se o usuário selecionar um arquivo, o programa mostra uma caixa de diálogo que contém o nome do arquivo.

#include <windows.h>
#include <shobjidl.h> 

int WINAPI wWinMain(HINSTANCE hInstance, HINSTANCE, PWSTR pCmdLine, int nCmdShow)
{
    HRESULT hr = CoInitializeEx(NULL, COINIT_APARTMENTTHREADED | 
        COINIT_DISABLE_OLE1DDE);
    if (SUCCEEDED(hr))
    {
        IFileOpenDialog *pFileOpen;

        // Create the FileOpenDialog object.
        hr = CoCreateInstance(CLSID_FileOpenDialog, NULL, CLSCTX_ALL, 
                IID_IFileOpenDialog, reinterpret_cast<void**>(&pFileOpen));

        if (SUCCEEDED(hr))
        {
            // Show the Open dialog box.
            hr = pFileOpen->Show(NULL);

            // Get the file name from the dialog box.
            if (SUCCEEDED(hr))
            {
                IShellItem *pItem;
                hr = pFileOpen->GetResult(&pItem);
                if (SUCCEEDED(hr))
                {
                    PWSTR pszFilePath;
                    hr = pItem->GetDisplayName(SIGDN_FILESYSPATH, &pszFilePath);

                    // Display the file name to the user.
                    if (SUCCEEDED(hr))
                    {
                        MessageBoxW(NULL, pszFilePath, L"File Path", MB_OK);
                        CoTaskMemFree(pszFilePath);
                    }
                    pItem->Release();
                }
            }
            pFileOpen->Release();
        }
        CoUninitialize();
    }
    return 0;
}

Este código usa alguns conceitos que serão descritos mais adiante no módulo, então não se preocupe se você não entender tudo aqui. Aqui está um esboço básico do código:

1. Chame CoInitializeEx para inicializar a biblioteca COM.
2. Chame CoCreateInstance para criar o objeto Common Item Dialog e obter um ponteiro para a interfaceIFileOpenDialogdo objeto.
3. Chame o método Show do objeto, que mostra a caixa de diálogo para o usuário. Esse método bloqueia até que o usuário dispense a caixa de diálogo.
4. Chame o do objeto GetResult método. Esse método retorna um ponteiro para um segundo objeto COM, chamado de item Shell objeto. O item Shell, que implementa a interfaceIShellItem, representa o arquivo selecionado pelo usuário.
5. Chame o do item do Shell GetDisplayName método. Este método obtém o caminho do arquivo, na forma de uma cadeia de caracteres.
6. Mostrar uma caixa de mensagem que exibe o caminho do arquivo.
7. Chame CoUninitialize para desinicializar a biblioteca COM.

As etapas 1, 2 e 7 chamam funções definidas pela biblioteca COM. Estas são funções COM genéricas. As etapas 3 a 5 chamam métodos definidos pelo objeto Common Item Dialog.

Este exemplo mostra as duas variedades de criação de objetos: O genérico CoCreateInstance função e um método (GetResult) que é específico para o objeto Common Item Dialog.

Seguinte

Gerenciando o tempo de vida de um objeto

Tópicos relacionados

Exemplo de caixa de diálogo Abrir