PrintManager Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Fornece o ponto de entrada para impressão em um aplicativo.
public ref class PrintManager sealed/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class PrintManager final[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class PrintManagerPublic NotInheritable Class PrintManager- Herança
- Atributos
Requisitos do Windows
| Família de dispositivos |
Windows 10 (introduzida na 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
|
| API contract |
Windows.Foundation.UniversalApiContract (introduzida na v1.0)
|
Comentários
A classe PrintManager é responsável por orquestrar o fluxo de impressão para aplicativos UWP. Para usar essa classe, você deve primeiro chamar o método GetForCurrentView . Esse método retorna o objeto PrintManager específico da janela ativa atual. Em seguida, você deve adicionar um ouvinte de eventos para o evento PrintTaskRequested . Esse evento é gerado quando o aplicativo invoca a caixa de diálogo de impressão por meio do método ShowPrintUIAsync .
Quando um aplicativo UWP registra sua "intenção" de imprimir, ele cria um contrato de impressão com o gerenciador de impressão. Na amostra de impressão UWP, o registro é executado pelo método RegisterForPrinting.
public virtual void RegisterForPrinting()
{
printDocument = new PrintDocument();
printDocumentSource = printDocument.DocumentSource;
printDocument.Paginate += CreatePrintPreviewPages;
printDocument.GetPreviewPage += GetPrintPreviewPage;
printDocument.AddPages += AddPrintPages;
PrintManager printMan = PrintManager.GetForCurrentView();
printMan.PrintTaskRequested += PrintTaskRequested;
}
Para obter mais exemplos envolvendo o gerenciador de impressão e ver alguns exemplos de código para cenários de impressão em aplicativos UWP, consulte Impressão e o exemplo de impressão UWP.
Histórico de versão
| Versão do Windows | Versão do SDK | Valor adicionado |
|---|---|---|
| 1607 | 14393 | Issupported |
Métodos
| GetForCurrentView() |
Recupera o objeto PrintManager associado à janela atual. |
| IsSupported() |
Indica se o aplicativo está ou não em execução em um dispositivo que dá suporte à impressão. |
| ShowPrintUIAsync() |
Inicia programaticamente a interface do usuário para imprimir conteúdo. |
Eventos
| PrintTaskRequested |
Gerado quando ocorreu uma solicitação de impressão. Esse evento pode ser disparado pela ação do usuário ou por meio da invocação programática da impressão por meio do método ShowPrintUIAsync . |