다음을 통해 공유


ProgressBar 컨트롤

ProgressBar 컨트롤은 진행률 메시지를 받을 때 길이를 변경하는 막대 그래프를 표시합니다. 이 컨트롤은 SetProgress ControlEvent를 구독합니다. 모니터링되는 작업의 이름을 따서 명명된 ControlEvent를 구독할 수 있습니다.

관련 정보는 ProgressBar 컨트롤 작성ProgressBar에 사용자 지정 작업 추가를 참조하세요.

컨트롤 특성

이 컨트롤에서 다음 특성을 사용할 수 있습니다. 이벤트를 사용하여 특성값을 변경하려면 EventMapping 테이블의 ControlEvent에 컨트롤을 구독하고 특성 열에 특성의 식별자를 나열합니다. 이벤트 열에 ControlEvent의 식별자를 입력합니다.

특성 식별자 16진수 비트 설명
위치 대화 상자에서 컨트롤의 위치입니다. 컨트롤의 왼쪽 모서리에 있는 컨트롤의 너비, 높이 및 좌표를 Control 테이블의 너비, 높이, X 및 Y 열에 입력합니다. 길이 및 거리에 설치 관리자 단위를 사용합니다.
진행률   이 특성은 ProgressBar가 채워지는 크기를 지정합니다. 특성은 두 개의 정수와 문자열로 구성됩니다. 첫 번째 정수 필드는 현재 진행률 틱 수이고 두 번째 정수 필드는 기본 최대 진행률 틱 수(1024)입니다. 세 번째 필드는 진행 중인 작업의 이름인 문자열입니다. 현재 진행률 틱 수가 최댓값보다 크면 설치 관리자가 이를 최댓값으로 변경합니다. 이 특성은 SetProgress ControlEvent에서 설정 및 변경합니다. Event 열에 SetProgress를 입력하고 Attribute 열에 Progress를 입력하여 EventMapping 테이블에서 이 이벤트에 대한 컨트롤을 구독해야 합니다.
Text 컨트롤에 의해 표시된 텍스트입니다. 텍스트 문자열의 글꼴 및 글꼴 스타일을 설정하려면 표시된 문자의 문자열 앞에 {\style} 또는 {&style}을 접두사로 묶습니다. 여기서 style은 TextStyle 테이블의 TextStyle 열에 나열된 식별자입니다. 둘 중 어느 것도 없지만 DefaultUIFont 속성이 유효한 텍스트 스타일로 정의된 경우 앞의 글꼴이 사용됩니다.
Visible 0x00000000 0x00000001
숨겨진 컨트롤입니다. 표시되는 컨트롤입니다.
컨트롤 테이블의 속성 열 비트 단어에 이 비트를 포함하면 컨트롤을 만들 때 컨트롤이 표시되거나 숨겨집니다.
ControlCondition 테이블을 사용하여 컨트롤을 숨기거나 표시할 수도 있습니다.
Sunken 0x00000000 0x00000004
기본 비주얼 스타일을 표시합니다. 움푹 들어간 3D 모양으로 컨트롤을 표시합니다.
컨트롤 테이블의 특성 열에 비트 단어에 해당 비트를 포함합니다.
RTLRO 0x00000000 0x00000020
컨트롤의 텍스트는 왼쪽에서 오른쪽 읽기 순서로 표시됩니다. 컨트롤의 텍스트는 오른쪽에서 왼쪽으로 읽기 순서로 표시됩니다.
Progress95 0x00000000 0x00010000
연속 막대로 그려진 진행률 표시줄입니다. 일련의 사각형으로 그려진 진행률 표시줄입니다.
Control 테이블의 Attributes 열 비트 단어에 이러한 비트를 포함합니다.

 

설명

이 컨트롤은 CreateWindowEx 함수를 사용하여 PROGRESS_CLASS 클래스에서 만들 수 있습니다. WS_CHILDWS_GROUP 스타일이 있습니다.