---
title: "ChoiceFile - Показать диалог и выбрать в нем имя файла для чтения"
type: guide
api: [api7]
tags: [guide, api7, choicefile]
sources:
  - choicefile.html
---

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

Пример...
Аналог данной функции при использовании Automation - метод KompasObject::ksChoiceFile.
Синтаксис:
```
unsigned int ChoiceFile (char *ext, char *filtr, char *name, unsigned int sizeBuf);
Входные параметры:
ext    - расширение имени файла,
filtr    - фильтр поиска (0 - формируется автоматически),
sizeBuf    - размер буфера для имени файла.
Выходные параметры:
name    - буфер для имени файла.
Возвращаемое значение:
длина имени файла    - в случае удачного завершения,
NULL    - в случае отказа от выбора.
```
