다음을 통해 공유

TESTHELP 샘플: 도구 설명 및 도움말을 가진 ActiveX 컨트롤

  • 아티클

업데이트: 2007년 11월

TESTHELP 샘플은 MFC를 사용하여 사용자에게 도움말을 표시하기 위해 고유한 도움말 파일을 가진 ActiveX 컨트롤을 빌드하는 방법을 보여 줍니다. 또한 Testhelp.ocx는 MFC ActiveX 컨트롤에 도구 설명을 추가하는 방법을 보여 줍니다.

보안 정보:

이 샘플 코드는 개념을 보여 주기 위해 제공되며 가장 안전한 코드 작성 방법을 제시하지 않을 수 있으므로 응용 프로그램이나 웹 사이트에서 사용할 수 없습니다. Microsoft는 샘플 코드를 원래 용도 이외의 다른 용도로 사용하는 경우 발생하는 부수적이나 파생적인 손해에 대해 책임을 지지 않습니다.

샘플 및 이를 설치하기 위한 지침을 가져오려면

  • Visual Studio의 도움말 메뉴에서 샘플을 클릭합니다.

    자세한 내용은 샘플 파일 찾기를 참조하십시오.

  • 최신 버전 및 전체 샘플 목록은 Visual Studio 2008 Samples 페이지에서 온라인으로 사용할 수 있습니다.

  • 컴퓨터의 하드 디스크에서도 샘플을 찾을 수 있습니다. 기본적으로 샘플과 추가 정보 파일은 \Program Files\Visual Studio 9.0\Samples\ 아래의 폴더에 복사됩니다. Visual Studio Express Edition의 경우에는 모든 샘플이 온라인에 있습니다.

샘플 빌드 및 실행

TESTHELP 샘플을 빌드 및 실행하려면

  1. Testhelp.sln 솔루션을 엽니다.

  2. 빌드 메뉴에서 빌드를 클릭합니다.

TESTHELP 샘플을 빌드한 후 ActiveX 컨테이너 응용 프로그램에서 이 샘플을 사용할 수 있습니다. 테스트 컨테이너에 액세스하는 방법에 대한 자세한 내용은 Test Container를 사용하여 속성 및 이벤트 테스트를 참조하십시오. TESTHELP 컨트롤을 컨테이너의 프로젝트에 포함하고 이 프로젝트를 실행합니다. 컨테이너의 속성 대화 상자를 열어 TESTHELP 컨트롤의 속성을 설정할 수 있습니다.

도움말 프로젝트 파일과 모든 도움말 프로젝트의 소스 파일도 이 샘플에 포함됩니다.

TESTHELP 도움말 파일을 다시 빌드하고 실행하려면

  1. 시작 메뉴에서 Help Workshop을 클릭합니다.

  2. Testhelp.hpj를 엽니다. Help Workshop에서 이 파일을 .hhp 파일로 변환하기 위한 마법사를 표시합니다. 이 마법사를 실행한 다음 파일 이름을 지정하고 변경 내용을 적용합니다.

  3. File 메뉴에서 Compile을 클릭합니다. Create a compiled file 대화 상자에서 컴파일된 파일을 저장할 위치를 가리킨 다음 Compile을 클릭합니다.

  4. 컴파일된 파일을 보려면 View 메뉴에서 Compiled Help File을 클릭합니다.

TESTHELP 기능

TESTHELP는 다음 작업을 수행하는 방법을 보여 줍니다.

  • ActiveX 컨트롤에 대한 도구 설명을 표시합니다.

  • 컨트롤의 속성 페이지를 사용하여 도구 설명을 표시하고 숨깁니다.

  • 컨트롤의 속성 페이지를 사용하여 도구 설명의 텍스트를 변경합니다.

  • Help 단추를 클릭했을 때 컨트롤의 도움말 파일이 표시되도록 ActiveX 컨트롤 컨테이너의 속성 프레임 Help 단추를 활성화합니다.

  • Visual C++의 구성 요소 및 컨트롤 갤러리에서 컨트롤을 선택하고 "?" 단추를 클릭했을 때 해당 컨트롤의 도움말 파일이 표시되도록 이 갤러리에서 "?" 단추를 활성화합니다.

  • 컨트롤에 키보드 포커스가 있는 상태에서 F1 키를 눌렀을 때 런타임에서 도움말을 표시합니다.

  • ActiveX 컨트롤의 Font, BackColor 및 ForeColor 스톡 속성을 사용합니다.

일반 속성 페이지

  • Type of Help to Use
    이 속성은 TESTHELP 컨트롤에 키보드 포커스가 있는 상태에서 사용자가 F1 키를 눌렀을 때 도움말이 사용되는 방법을 결정합니다. 팝업 창의 도움말은 TESTHELP 컨트롤이 컨테이너에서 실행 중이고 이 컨트롤에 키보드 포커스가 있는 상태에서 사용자가 F1 키를 눌렀을 때 Testhelp.hlp 도움말 파일의 "What is this thing?" 항목이 들어 있는 팝업 창이 표시된다는 것을 의미합니다. Show the Whole Help File은 TESTHELP 컨트롤이 컨테이너에서 실행 중이고 이 컨트롤에 키보드 포커스가 있는 상태에서 사용자가 F1 키를 눌렀을 때 전체 Windows 도움말 프로그램이 나타나 Testhelp.hlp 파일의 목차 항목을 표시한다는 것을 의미합니다.

  • Use Control's Help File
    이 상자를 선택하면 컨트롤이 컨테이너에서 실행 중이고 키보드 포커스를 가진 상태에서 사용자가 F1 키를 눌렀을 때 Type of Help to Use 속성에 의해 결정된 형식으로 도움말이 표시됩니다.

  • Use ToolTip for this Control
    이 상자를 선택하면 컨트롤이 컨테이너에서 실행 중이고 마우스 커서를 컨트롤 창으로 이동하여 멈출 경우 컨트롤 창 위에 도구 설명이 표시됩니다. 표시되는 텍스트는 Tooltip Caption 속성에 의해 결정됩니다.

  • Tooltip Caption
    사용자가 도구 설명을 표시하도록 선택한 경우 도구 설명에 표시되는 텍스트입니다.

    • Name1   컨트롤 위쪽에 표시되는 이름입니다.

    • Name2   컨트롤 중간에 표시되는 이름입니다.

    • Name3   컨트롤 아래쪽에 표시되는 이름입니다.

Color 속성 페이지

이 컨트롤을 그리는 데 사용되는 색을 선택할 수 있습니다.

Font 속성 페이지

컨트롤의 텍스트에 사용되는 글꼴을 지정할 수 있습니다.

참고:

이 샘플을 비롯한 일부 샘플은 Visual C++ 마법사, 라이브러리 및 컴파일러의 변경 내용을 반영하도록 수정되지 않았지만 해당 작업의 수행 방법을 보여 줍니다.

키워드

TESTHELP 샘플은 다음과 같은 클래스 및 키워드를 보여 줍니다.

CToolTipCtrl; COleControl::OnDraw; COleControl::OnResetState; COlePropertyPage::OnHelp

참고:

이 샘플을 비롯한 일부 샘플은 Visual C++ 마법사, 라이브러리 및 컴파일러의 변경 내용을 반영하도록 수정되지 않았지만 해당 작업의 수행 방법을 보여 줍니다.

참고 항목

기타 리소스

MFC 샘플