---
title: "ksPrintPreviewWindow - Открыть окно предварительного просмотра документа перед печатью"
type: guide
api: [api7]
tags: [guide, api7, ksprintpreviewwindow]
sources:
  - ksprintpreviewwindow.html
---

*API экспортных функций > Функции работы с документами  > Функции вывода на печать *


## ksPrintPreviewWindow - Открыть окно предварительного просмотра документа перед печатью

Пример...
Аналог данной функции при использовании Automation - метод KompasObject::ksPrintPreviewWindow.
Синтаксис:
```
int ksPrintPreviewWindow (reference docsArr, int inquiry);
Входные параметры:
docsArr    - массив типа CHAR_STR_ARR или CHAR_STR_ARR_W полных имен документов, которые нужно распечатать,
inquiry    - признак запроса документов: 1 - если docsArr = NULL или массив пуст, запросить документы у пользователя, 0 - показать документы без запроса.
Возвращаемое значение:
1    - в случае удачного завершения,
0    - в случае неудачи.
```


## ksPrintPreviewWindow - пример использования

char buf[128];
//создать динамический массив строк
reference docsArr = CreateArray(CHAR_STR_ARR,0);
//наполним массив
strcpy(buf,"d:\\0\\_222.cdw");
AddArrayItem(docsArr, -1, buf, sizeof(buf));
strcpy(buf,"d:\\0\\_2.cdw");
AddArrayItem(docsArr, -1, buf, sizeof(buf));
//в просмотровом окне должно появиться два документа, которые нужно распечатать
if (! ksPrintPreviewWindow(docsArr, // динамический массив указателей CHAR_STR_ARR
1)) { // 1 - если docsArr = 0 или массив пуст,
// запросить документы у пользователя
// 0 - без запроса
// если неудачное завершение - выдадим результат работы нашей функции
MessageBoxResult();