[Reference] Vcl.FileCtrl.SelectDirectory

Vcl.FileCtrl.SelectDirectory

Delphi

function SelectDirectory(var Directory: string; Options: TSelectDirOpts; HelpCtx: Longint): Boolean;

function SelectDirectory(const Caption: string; const Root: WideString; var Directory: string; Options: TSelectDirExtOpts; Parent: TWinControl): Boolean;

C++

extern PACKAGE bool __fastcall SelectDirectory(System::UnicodeString &Directory, TSelectDirOpts Options, int HelpCtx)/* overload */;

Properties

Type	Visibility	Source	Unit	Parent
function	public	Vcl.FileCtrl.pas Vcl.FileCtrl.hpp	Vcl.FileCtrl	Vcl.FileCtrl

Description

Brings up a dialog to allow the user to enter a directory name.

Call SelectDirectory to let the user enter a directory name.

Use the first syntax to call the Select Directory dialog box.

The directory passed to the function with the Directory parameter / appears as the currently selected directory / when the dialog box appears.

The name of the directory the user selects / becomes the value of Directory when the function returns.

The HelpCtx parameter is the help context ID number.

 

사용자가 디렉토리 이름을 입력 할 수 있는 대화 상자를 표시합니다.

SelectDirectory를 호출하여 사용자가 디렉토리 이름을 입력하게 합니다.

첫 번째 구문을 사용하여 디렉터리 선택 대화 상자를 호출하십시오.

대화 상자가 나타나면 Directory 매개 변수가 있는 함수에 전달된 디렉터리가 현재 선택된 디렉터리로 나타납니다.

사용자가 선택하는 디렉토리의 이름은 함수가 리턴 할 때 Directory의 값이 됩니다.

HelpCtx 매개 변수는 도움말 컨텍스트 ID 번호입니다.

 

Use the second syntax to display the Windows directory browser.

The Caption parameter specifies a caption for the dialog.

The Root parameter specifies the root directory from which to browse.

The selected directory is returned as the Directory parameter.

When using this syntax, SelectDirectory does not change the value of the current directory.

Warning: You can't use the same variable for the Root parameter and the Directory parameter.

 

두 번째 구문을 사용하여 Windows 디렉터리 브라우저를 표시합니다.

Caption 매개 변수는 대화 상자의 캡션을 지정합니다.

Root 매개 변수는 탐색할 루트 디렉터리를 지정합니다.

선택한 디렉토리가 Directory 매개 변수로 리턴 됩니다.

이 구문을 사용할 때 SelectDirectory는 현재 디렉터리의 값을 변경하지 않습니다.

경고: Root 매개 변수와 Directory 매개 변수에는 동일한 변수를 사용할 수 없습니다.

 

The Options parameter is a set of values.

If Options is the empty set, the user can only select a directory that already exists.

No edit box is provided for the user to enter a new directory name.

If Options is not empty, the included values determine how the dialog responds when the user types a nonexistent directory name.

With either syntax, SelectDirectory returns true if the user selected a directory and chose OK, and false if the user chose Cancel or closed the dialog box without selecting a directory.

 

Options 매개 변수는 값 집합입니다.

Options이 빈 세트이면, 사용자는 이미 존재하는 디렉토리만 선택할 수 있습니다.

사용자가 새 디렉토리 이름을 입력 할 수 있는 편집 상자가 제공되지 않습니다.

Options이 비어 있지 않으면, 포함된 값에 따라 사용자가 존재하지 않는 디렉토리 이름을 입력 할 때 대화 상자가 응답하는 방식이 결정됩니다.

이 구문을 사용하면 SelectDirectory는 사용자가 디렉토리를 선택하고 OK를 선택한 경우에는 true를 반환하고 사용자가 Cancel을 선택하거나 디렉토리를 선택하지 않고 대화 상자를 닫은 경우 false를 반환합니다.

 

bring (brings) 미국·영국 [brɪŋ]  1. 가져오다, 데려오다  2. 가져다 주다  3. 야기하다, 가져오다 allow 미국·영국 [ə|laʊ]  1. (무엇을 하도록) 허락하다; 용납하다 2. (무엇을 가지도록) 허락하다 3. 들어오게 하다 let 미국·영국 [let]  1. (…하게) 놓아두다 2. (…을 하도록) 허락하다 3. (어디에 가는 것을) 허용하다 let1 미국·영국 [lét]  1. …에게 …시키다, …하게 해 주다, …할 것을 허용하다(allow to) 2. 타동사 3. 들여보내다, 가게 하다 ((into, to, through, etc.)) become 미국·영국 [bɪ|kʌm]  1. …(해)지다, …이 되다 2. 알맞다, 적절하다 3. 어울리다, 보기 좋다 provide 미국·영국 [prə|vaɪd]  1. 제공하다, 주다 2. 규정하다 determine 미국식 [dɪ|t3:rmɪn]  1. 알아내다, 밝히다 2. (무엇의 방식・유형을) 결정하다 3. (공식적으로) 확정하다 either 미국·영국 [|aɪðə(r);|i:ðə(r)]  1. (둘 중) 어느 하나(의) 2. (두 개) 각각(의) 3. (부정문에서) …도 (그렇다)

 

출처: http://docwiki.embarcadero.com/Libraries/XE2/en/Vcl.FileCtrl.SelectDirectory