大网数据广告活动
安装更新与部署

Adding Text Stored in a Property

· 52CE 我爱测

The example described in the section titled Authoring a Conditional &\#0034;Please Wait .

The example described in the section titled Authoring a Conditional "Please Wait . . . " Message Box displays a dialog box with text that reads: "Please wait while disk space costing is completed." This could be done simply by putting a Text Control on the dialog box and entering the text string into the Text column of the Control table. In this case, the information about the font style must be embedded in the string. The author must set the font and font style by prefixing the character string with {\style}. Where style is a font style identifier listed in the TextStyle column of the TextStyle table. This method of adding text is illustrated several times in An Installation Example.

An author of a user interface can also store text in a property. The following example illustrates this and shows how ControlEvents can be used to display alternative text strings.

The objective in this example is again to put up a WaitForCosting dialog box while a background task is running. The difference with the new scenario is that if the user cancels the WaitForCosting dialog box and then tries to activate the control before the background task has finished a second time, the WaitForCosting box reappears displaying an alternative message: "Disk space costing is still running. You can continue to wait or return to the main selection box to exit this sequence."

To display a "Please Wait" dialog box that displays alternative messages

  1. Begin by adding a conditional WaitForCosting dialog box to a Selection dialog box as described in Authoring a Conditional "Please Wait . . . " Message Box.
  2. Put a Text Control on the WaitForCosting dialog box by authoring a record in the Control table. Enter the identifier of the WaitForCosting dialog box into the Dialog_ column. Enter the identifier of the Text control into the Control column. Specify the type of control as Text in the Type column.
  3. Specify the Position control attribute for the text control by entering the horizontal and vertical coordinates of the control's upper left corner in the X and Y columns of the Control table. Use pixels as distance units.
  4. Specify the width and height of the text control by entering these dimensions into the Width and Height columns of the Control table. Use pixels as length units.
  5. The Property and Control_Next columns of the Control table do not affect Text controls and can be left blank in this case.
  6. Specify the control attributes for the Text control that are associated with bit flags. Add the individual bit values together and enter the total into the Attributes column of the Control table. These are the Visible, Sunken, Enabled, Transparent, NoWrap, and NoPrefix control attributes. The combination of bits that display a text control on an opaque background, with wrapping text is 0, therefore enter 0 or leave the Attributes column blank.
  7. The Text column of the Control table can be left blank. The Text control displays the text string that is the value of the Text control attribute. The method for setting this attribute is described in subsequent steps of this procedure.
  8. Add a record in the Property table to define the FirstMessage message property. This property is a string containing the font style and text for the first message. Enter the name FirstMessage in the Property column. In the Value column, enter the string: "{\WaitStyle}Please wait while disk space costing is completed." Where WaitStyle is an identifier for one of the font styles listed in the TextStyle column of the TextStyle table.
  9. Add a record in the Property table to define the SecondMessage message property. This property is a string containing the font style and text for the second message. Enter the name SecondMessage in the Property column. In the Value column enter the string: "{\WaitStyle}Disk space costing is still running. You can continue to wait or return to the main selection box to exit this sequence."
  10. Add a record in the Property table to define the WaitMessage message property. This property is a string containing the font style and text for the message displayed in the WaitForCosting dialog box if the user tries to activate a push button before costing is completed. Enter the name WaitMessage in the Property column. In the Value column of the Property table enter: FirstMessage.
  11. Add a SetProperty ControlEvent to the ControlEvent table that initializes WaitMessage to FirstMessage each time a New Selection dialog box opens. Enter the identifier for the dialog box that comes just before the Selection dialog in the dialog box sequence into the Dialog_ column. Enter the identifier for the control on this dialog box used to open the Selection dialog box into the Control_ column. Enter [WaitMessage] into the Event column. Enter [FirstMessage] into the Argument column. Enter 1 into the Condition column and leave the Ordering column blank.
  12. Add a SetProperty ControlEvent to the ControlEvent table that sets Waitmessage to SecondMessage if the user closes the WaitForCosting dialog box before disk space costing has completed. Enter the identifier for the WaitForCosting dialog box into the Dialog_ column. Enter the identifier for the Text control into the Control_ column. Enter [WaitMessage] into the Event column. Enter [SecondMessage] into the Argument column. Enter NOT CostingComplete into the Condition column and leave the Ordering column blank.
  13. The following step links the Text control attribute to the ControlEvent that spawns the WaitForCosting dialog box. This causes the installer to pass the value of the WaitMessage property to the Text control attribute each time the user opens a WaitForCosting dialog box.
  14. Subscribe the Text control attribute of the Text control to the SpawnWaitDialog ControlEvent that opens the WaitForCosting dialog box by adding a record to the EventMapping table. Enter the identifier for the WaitForCosting dialog box in the Dialog_ column. Enter the identifier for the Text control into the Control_ column. Enter SpawnWaitDialog into the Event column. Enter Text, the identifier for the Text control attribute, into the Attribute column of the EventMapping table.

Source: Microsoft Learn / Windows Win32 documentation by Microsoft and contributors. Documentation licensed CC BY 4.0. Code samples are covered by the MIT License. Converted from Markdown, with links normalized and embedded media omitted.

资料来源与适用范围

资料来源
Microsoft Learn / Windows Win32 documentation
适用范围
Windows Win32 API · Source date 05/31/2018
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY 4.0 (documentation), MIT (code samples)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。