Assistente de Impressão Online

O Assistente de Impressão Online do Windows Vista ajuda os usuários a solicitar impressões de fotos de varejistas de impressão online participantes. Esse assistente foi projetado para que ele possa ser invocado programaticamente por qualquer aplicativo que queira oferecer aos usuários a capacidade de solicitar impressões de fotos. O Assistente para Impressão de Fotos está disponível no Windows Vista. PIX para Windows

• Recursos fornecidos pelo Assistente de Impressão Online
• Formatos de arquivo de foto com suporte
• Iniciando programaticamente o Assistente de Impressão Online
• Acessando o ícone do Assistente de Impressão Online
• Propriedades do MRU do Assistente de Impressão Online

Recursos fornecidos pelo Assistente de Impressão Online

O Assistente de Impressão Online do Windows Vista permite que os usuários solicitem impressões de uma seleção de varejistas de impressão online participantes. Quando invocado, o assistente:

1. Aceita um arquivo ou uma lista de arquivos para os quais as impressões devem ser ordenadas.
2. Recupera automaticamente a lista atual de varejistas de impressão online participantes e permite que o usuário selecione o varejista do qual comprar as impressões fotográficas.
3. Orienta o usuário pelo processo ou ordenação de impressões.

Qualquer aplicativo pode se beneficiar dos recursos oferecidos pelo Assistente de Impressão do Windows Vista Online. Um aplicativo só precisa passar o arquivo ou arquivos para os quais as impressões serão ordenadas e o assistente orienta o usuário durante o processo de ordenação.

A figura a seguir mostra o Assistente de Impressão Online do Windows Vista exibindo uma lista de exemplos de varejistas de impressão online participantes.

Formatos de arquivo de foto com suporte

O Assistente de Impressão online do Windows Vista dá suporte a qualquer formato de arquivo de imagem para o qual um codec do Componente de Imagem do Windows (WIC) está instalado. O WIC fornece vários codecs padrão, incluindo:

• BMP (Bitmap)
• GIF
• Formato de ícone (ICO)
• JPEG
• PNG
• TIFF
• Formato de foto do Windows Media

Para obter mais informações sobre codecs WIC e WIC, consulte Componente de imagem do Windows.

Os formatos de arquivo compatíveis com os varejistas de impressão online variam de varejista para varejista; É possível que um determinado varejista não dê suporte a todos os formatos de arquivo compatíveis com o Assistente de Impressão do Windows Vista Online. Se o usuário tentar solicitar impressões em um formato sem suporte do revendedor selecionado, o Assistente de Impressão do Windows Vista Online notificará o usuário de que o revendedor selecionado não dá suporte ao formato de arquivo enviado.

Iniciando programaticamente o Assistente de Impressão Online

Para invocar o Assistente de Impressão do Windows Vista Online, chame a interface IDropTarget com o seguinte CLSID (identificador de classe):

CLSID_PublishDropTarget

Esse CLSID é definido em Shobjidl.h e Shobjidl.idl. Os arquivos a serem processados pelo Assistente de Impressão online do Windows Vista são especificados em um objeto IDataObject .

O exemplo de código a seguir demonstra como invocar o Assistente de Impressão do Windows Vista Online.

// 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);}

Acessando o ícone do Assistente de Impressão Online

O Assistente de Impressão online do Windows Vista exporta um ícone que pode ser acessado e exibido por aplicativos que o chamam. A figura a seguir mostra o ícone do Assistente de Impressão Online do Windows Vista.

O exemplo de código a seguir demonstra como recuperar o índice para o ícone do Assistente de Impressão online do Windows Vista lendo a propriedade 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;
}

Propriedades do MRU do Assistente de Impressão Online

O Assistente de Impressão Online do Windows Vista define três propriedades relacionadas ao varejista de impressão online mru (usado mais recentemente).

Nome da propriedade	Valor/Função da Propriedade
MRUIcon	O índice do ícone para o varejista de impressão online usado mais recentemente pode ser lido desta propriedade.
MRUName	O nome do varejista de impressão online usado mais recentemente pode ser lido desta propriedade.
UseMRU	Um valor variant VT_BOOL indicando se o assistente deve ignorar a página de seleção do varejista de impressão online e apenas usar o varejista de impressão online usado mais recentemente. Defina essa propriedade como VARIANT_TRUE para ignorar a página de seleção do varejista.

 

O exemplo de código a seguir demonstra como definir a propriedade UseMRU para que o Assistente de Impressão online do Windows Vista ignore a página de seleção do varejista de impressão online e selecione automaticamente o revendedor usado mais recentemente.

// 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);

O exemplo de código a seguir demonstra como ler as propriedades MRUName e 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;
}