Panduan Pencetakan Online

Windows Vista Online Printing Wizard membantu pengguna memesan cetakan foto dari pengecer pencetakan online yang berpartisipasi. Wizard ini dirancang agar dapat dipanggil secara terprogram oleh aplikasi apa pun yang ingin menawarkan pengguna kemampuan untuk memesan cetakan foto. Wisaya Pencetakan Foto tersedia di Windows Vista. PIX untuk Windows

• Fitur yang Disediakan oleh Wizard Cetak Online
• Format File Foto yang Didukung
• Meluncurkan Wizard Cetak Online secara Terprogram
• Mengakses Ikon Wizard Cetak Online
• Properti MRU Wizard Cetak Online

Fitur yang Disediakan oleh Wizard Cetak Online

Windows Vista Online Printing Wizard memungkinkan pengguna untuk memesan cetak dari pilihan pengecer pencetakan online yang berpartisipasi. Saat dipanggil, wizard:

1. Menerima file atau daftar file yang cetaknya akan diurutkan.
2. Secara otomatis mengambil daftar peritel pencetakan online yang berpartisipasi saat ini, dan memungkinkan pengguna untuk memilih peritel tempat membeli cetakan foto.
3. Memandu pengguna melalui proses atau memesan cetakan.

Aplikasi apa pun dapat memperoleh manfaat dari fitur yang ditawarkan oleh Windows Vista Online Printing Wizard. Aplikasi hanya perlu meneruskan file atau file yang cetaknya akan diurutkan, dan wizard memandu pengguna melalui proses pemesanan.

Gambar berikut menunjukkan Panduan Pencetakan Online Windows Vista yang menampilkan contoh daftar pengecer pencetakan online yang berpartisipasi.

Format File Foto yang Didukung

Windows Vista Online Printing Wizard mendukung format file gambar apa pun di mana codec Windows Imaging Component (WIC) diinstal. WIC menyediakan beberapa codec standar, termasuk:

• Bitmap (BMP)
• Format Pertukaran Grafik (GIF)
• Format Ikon (ICO)
• Joint Photographic Experts Group (JPEG)
• Grafis Jaringan Portabel (PNG)
• Format File Gambar Bertag (TIFF)
• Format Foto Media Windows

Untuk informasi selengkapnya tentang codec WIC dan WIC, lihat Komponen Pencitraan Windows.

Format file yang didukung oleh pengecer pencetakan online bervariasi dari pengecer ke pengecer; ada kemungkinan bahwa peritel tertentu mungkin tidak mendukung semua format file yang didukung oleh Windows Vista Online Printing Wizard. Jika pengguna mencoba memesan cetak dalam format yang tidak didukung oleh pengecer yang dipilih, Windows Vista Online Printing Wizard memberi tahu pengguna bahwa pengecer yang dipilih tidak mendukung format file yang dikirimkan.

Meluncurkan Wizard Cetak Online secara Terprogram

Untuk memanggil Windows Vista Online Printing Wizard, panggil antarmuka IDropTarget dengan pengidentifikasi kelas berikut (CLSID):

CLSID_PublishDropTarget

CLSID ini didefinisikan dalam Shobjidl.h dan Shobjidl.idl. File yang akan diproses oleh Windows Vista Online Printing Wizard ditentukan dalam objek IDataObject.

Contoh kode berikut menunjukkan cara memanggil Windows Vista Online Printing Wizard.

// A data object that contains the list of photos to print.
IDataObject* pDataObject;

// Create the Photo Printing Wizard drop target.
CComPtr<IDropTarget> spDropTarget;
        
hr = CoCreateInstance(CLSID_PublishDropTarget,
                      NULL,
                      CLSCTX_INPROC_SERVER,
                      IID_PPV_ARGS(&spDropTarget));

// Drop the data object onto the drop target.
POINTL pt = {0};
DWORD dwEffect = DROPEFFECT_LINK | DROPEFFECT_MOVE | DROPEFFECT_COPY;

spDropTarget->DragEnter(pDataObject, MK_LBUTTON, pt, &dwEffect);

spDropTarget->Drop(pDataObject, MK_LBUTTON, pt, &dwEffect);}

Mengakses Ikon Wizard Cetak Online

Windows Vista Online Printing Wizard mengekspor ikon yang dapat diakses dan ditampilkan oleh aplikasi yang menyebutnya. Gambar berikut ini memperlihatkan ikon Windows Vista Online Printing Wizard.

Contoh kode berikut menunjukkan cara mengambil indeks untuk ikon Windows Vista Online Printing Wizard dengan membaca properti OPWIcon.

// Create the Online Printing Wizard drop target.
CComPtr<IDropTarget> spDropTarget;
        
HRESULT hr = CoCreateInstance(CLSID_PublishDropTarget,
                              NULL,
                              CLSCTX_INPROC_SERVER,
                              IID_PPV_ARGS(&spDropTarget));

// Get the Online Printing Wizard properties.
CComPtr<IPropertyBag> spPropsBag;

spDropTarget->QueryInterface(IID_PPV_ARGS(&spPropsBag));

// Read the icon index from the properties set. 
CComVariant vtIcon;
int nIndex;
hr = spPropsBag->Read(L"OPWIcon", &vtIcon, NULL);

if SUCCEEDED(hr)
{
    nIndex = vtIcon.lVal;
}

Properti MRU Panduan Cetak Online

Windows Vista Online Printing Wizard mendefinisikan tiga properti yang terkait dengan pengecer pencetakan online (MRU) yang terakhir digunakan.

Contoh kode berikut menunjukkan cara mengatur properti UseMRU sehingga Windows Vista Online Printing Wizard melewati halaman pemilihan pengecer pencetakan online dan secara otomatis memilih peritel yang terakhir digunakan.

// A data object that contains the list of photos to order prints for.
IDataObject* pDataObject;

// Create the Online Printing Wizard drop target.
CComPtr<IDropTarget> spDropTarget;
        
HRESULT hr = CoCreateInstance(CLSID_PublishDropTarget,
                              NULL,
                              CLSCTX_INPROC_SERVER,
                              IID_PPV_ARGS(&spDropTarget));

// Set the UserMRU property to true to skip retailer selection and use 
// the MRU retailer instead.    
CComQIPtr<IPropertyBag> spPropsBag(spDropTarget);
if(spPropsBag) 
{
    VARIANT varTrue = {0};
    varTrue.vt = VT_BOOL;
    varTrue.boolVal = VARIANT_TRUE;
    spPropsBag->Write(L"UseMRU", &varTrue);
}

// Drop the data object onto the drop target.
POINTL pt = {0};
DWORD dwEffect = DROPEFFECT_LINK | DROPEFFECT_MOVE | DROPEFFECT_COPY;

spDropTarget->DragEnter(pDataObject, MK_LBUTTON, pt, &dwEffect);

spDropTarget->Drop(pDataObject, MK_LBUTTON, pt, &dwEffect);

Contoh kode berikut menunjukkan cara membaca properti MRUName dan MRUIcon.

// Create the Online Printing Wizard drop target.
CComPtr<IDropTarget> spDropTarget;
        
HRESULT hr = CoCreateInstance(CLSID_PublishDropTarget,
                              NULL,
                              CLSCTX_INPROC_SERVER,
                              IID_PPV_ARGS(&spDropTarget));

// Get the Online Printing Wizard properties.
CComPtr<IPropertyBag> spPropsBag;
spDropTarget->QueryInterface(IID_PPV_ARGS(&spPropsBag));

CComVariant vtMRUName, vtMRUIconIndex;
CComBSTR bstrMRUName;
int nMRUIconIndex;

// Get the MRU name value.
hr = spPropsBag->Read(L"MRUName", &vtMRUName, NULL);
if SUCCEEDED(hr) 
{
    bstrMRUName = vtMRUName.bstrVal;
}

// Get the MRU icon index value.
hr = spPropsBag->Read(L"MRUIcon", &vtMRUIconIndex, NULL);
if SUCCEEDED(hr)
{
    nMRUIconIndex = vtMRUIconIndex.lVal;
}