FormNew

Description
ID 폼을 리소스 데이터베이스로부터 읽어오고 그 폼에 연결되어 있는 컴포넌트도 읽어온다. 만약 해당 폼이 리소스 데이터베이스에 없거나 폼 스택이 꽉 찬 경우, 컴포넌트를 리소스 데이터베이스로부터 읽을 수 없는 경우에는 FALSE를 리턴하고 성공적으로 폼을 읽은 경우에는 TRUE를 리턴한다.

Syntax
Boolean FormNew( U16 ID )

Parameters
ID 폼 아이디

Returns
value설명
TRUE리소스 데이터베이스에 성공적으로 폼을 읽은 경우
FALSE리소스 데이터베이스에 폼이 없거나 폼 스택이 찬 경우

Comments
정상적으로 폼을 생성할 수 없는 경우 ( 리소스 데이터에 문제가 있거나 메모리가 부족한 경우 등 ) 에는 FALSE가 리턴되는데 이런 경우에는 그 이하의 폼 관련 함수 ( 특히, FormDraw, FormFree ) 를 호출하여서는 안된다.

Example
다음은 가장 일반적인 ApplicationHandleEvent 함수를 보여준다.

Boolean ApplicationHandleEvent( EventStruct * e )
{
   Boolean handled = FALSE;
  
   if( e->EventType == FORMLOADEVENT )
   {
     FormNew( id = e->ObjectID );
     switch( id )
     {
       case Form_fmMemoList_1000 :
       FormSetEventHandler( MemoMainHandleEvent );
       ...
       /* 폼을 화면에 그리기 전에 필요한 초기화가 있으면 여기에 코드를 추가한다 */
     }
     FormDraw();
     handled = TRUE;
   }
   else if( e->EventType == FORMUNLOADEVENT )
   {
     FormFree();
     handled = TRUE;
   }
return handled;