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

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

Пример...
Аналог данной функции при использовании Automation - метод KompasObject::ksChoiceFile
Синтаксис:
```
unsigned int ksChoiceFile (char *ext,
char * filter,
char * name,
unsigned int bufLen,
unsigned char preview);
Входные параметры:
Ext    - расширение имени файла,
Filter    - фильтр поиска (0 - формируется автоматически),
Preview    - признак подключения окна предварительного просмотра: 1 - с подключением окна, 0 - без подключения окна.
Выходные параметры:
Name    - буфер для имени файла,
bufLen    - длина отведенного буфера для name в символах.
Возвращаемое значение:
требуемая длина буфера в символах    - в случае удачного завершения,
NULL    - в случае отказа от выбора.
```
Примечание:
1. Если размер отведенного буфера bufLen меньше требуемой длины, то имя файла не заполняется. В этом случае имя файла можно получить функцией GetRightFileName.
2. При использовании Unicode следует использовать функцию ksChoiceFileW.
