---
title: "ksChoiceFileAppointedDirW - Выдать диалог выбора файла для чтения (Unicode)"
type: guide
api: [api7]
tags: [guide, api7, kschoicefileappointeddirw]
sources:
  - kschoicefileappointeddirw.html
---

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

Аналог данной функции при использовании Automation - метод KompasObject::ksChoiceFileAppointedDir
Синтаксис:
```
unsigned int LIB_FUNK ksChoiceFileAppointedDirW (LPWSTR ext,
LPWSTR filter,
LPWSTR name,
unsigned int bufLen,
unsigned char preview
int typeDir);
Входные параметры:
Ext    - расширение имени файла,
Filter    - фильтр поиска (0 - фильтр формируется автоматически),
preview    - признак подключения окна предварительного просмотра: 1 - с подключением окна, 0 - без подключения окна.
typeDir    - стартовая папка.
Выходные параметры:
name    - буфер для имени файла,
bufLen    - длина отведенного буфера для name в символах.
Возвращаемое значение:
требуемая длина буфера в символах    - в случае удачного завершения,
NULL    - в случае отказа от выбора.
```
Примечание:
1. Параметр typeDir может иметь значения:
– sptSYSTEM_FILES - 0 - открывается папка системных файлов,
– sptLIBS_FILES - 1 - открывается папка файлов библиотек. Во всех остальных случаях открывается текущая папка
2. Если размер отведенного буфера bufLen меньше требуемой длины - name не заполняется. В этом случае имя файла можно получить функцией GetRightFileName.
3. При использовании ANSI следует использовать функцию ksChoiceFileAppointedDir.
