Példa: A Megnyitás párbeszédpanel

A Shapes példa, amelyet használtunk, némileg átértelmezve. Váltsunk olyan COM-objektumra, amelyet egy valódi Windows-programban használhat: a Megnyitás párbeszédpanelen.

A megnyitása párbeszédpanel megjelenítéséhez a program használhatja a Közös elem párbeszédpanel objektum nevű COM-objektumot. A Közös elem párbeszédpanel egy IFileOpenDialognevű felületet implementál, amely a Shobjidl.h fejlécfájlban van deklarálva.

Íme egy program, amely megjeleníti a megnyitása párbeszédpanelt a felhasználó számára. Ha a felhasználó kiválaszt egy fájlt, a program megjeleníti a fájlnevet tartalmazó párbeszédpanelt.

#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;
}

Ez a kód néhány fogalmat használ, amelyeket a modul későbbi részében ismertetünk, ezért ne aggódjon, ha itt nem ért mindent. Íme a kód alapszintű vázlata:

1. A COM-kódtár inicializálásához hívja meg CoInitializeEx.
2. Hívja meg CoCreateInstance a Common Item Dialog objektum létrehozásához, és mutasson az objektum IFileOpenDialog felületére.
3. Hívja meg az objektum Megjelenítés metódusát, amely megjeleníti a párbeszédpanelt a felhasználónak. Ez a metódus addig blokkolja, amíg a felhasználó nem zárja be a párbeszédpanelt.
4. Hívja meg az objektum GetResult metódusát. Ez a metódus egy második COM-objektumra mutató mutatót ad vissza, amelyet Shell-elemnek objektumnak neveznek. Az IShellItemfelületet implementáló Shell-elem a felhasználó által kiválasztott fájlt jelöli.
5. Hívja meg a Shell-elem GetDisplayName metódusát. Ez a metódus sztring formájában kapja meg a fájl elérési útját.
6. A fájl elérési útját megjelenítő üzenetmező megjelenítése.
7. Hívja meg CoUninitialize a COM-kódtár inicializálásához.

A COM-kódtár által definiált 1., 2. és 7. lépés. Ezek általános COM-függvények. 3–5. lépés a Common Item Dialog objektum által meghatározott hívási metódusok.

Ez a példa az objektumlétrehozás mindkét fajtáját mutatja be: az általános CoCreateInstance függvényt, valamint a Common Item Dialog objektumra jellemző metódust (GetResult).

Következő

Objektum élettartamának kezelése

Kapcsolódó témakörök

Párbeszédpanel minta megnyitása