Skip to content

Commit b35ea2c

Browse files
committed
minor fixes
1 parent 9c60aca commit b35ea2c

10 files changed

+113
-127
lines changed

Library-Reference/Concepts/customize-the-office-fluent-ribbon-by-using-an-open-xml-formats-file.md

+21-21
Original file line numberDiff line numberDiff line change
@@ -8,14 +8,14 @@ ms.localizationpriority: medium
88

99
# Customize the Office Fluent ribbon by using an Open XML formats file
1010

11-
The ribbon component of the Microsoft Office Fluent user interface gives users a flexible way to work with Office applications. Ribbon Extensibility (RibbonX) uses a simple, text-based, declarative XML markup to create and customize the ribbon.
11+
The ribbon component of the Microsoft Office Fluent user interface gives users a flexible way to work with Office applications. Ribbon Extensibility (RibbonX) uses a simple, text-based, declarative XML markup to create and customize the ribbon.
1212

13-
The code example in this topic shows how to add custom components to the ribbon for a single document, as opposed to adding application-level customizations. In the following steps, you add a custom tab, a custom group, and a custom button to the existing ribbon in Word. You also implement a callback procedure for the button that inserts a company name into the document.
13+
The code example in this topic shows how to add custom components to the ribbon for a single document, as opposed to adding application-level customizations. In the following steps, you add a custom tab, a custom group, and a custom button to the existing ribbon in Word. You also implement a callback procedure for the button that inserts a company name into the document.
1414

1515
1. Create the customization file in any text editor and save the file with the name **customUI.xml**.
16-
17-
2. Add the following XML markup to the file and then close and save the file.
18-
16+
17+
2. Add the following XML markup to the file and then close and save the file.
18+
1919
```xml
2020
<customUI xmlns="http://schemas.microsoft.com/office/2006/01/customui">
2121
<ribbon>
@@ -31,16 +31,16 @@ The code example in this topic shows how to add custom components to the ribbon
3131
```
3232

3333
3. Create a folder on your desktop named **customUI** and copy the XML customization file to the folder.
34-
35-
4. Validate the XML markup with a custom schema.
36-
37-
> [!NOTE]
34+
35+
4. Validate the XML markup with a custom schema.
36+
37+
> [!NOTE]
3838
> This step is optional.
3939
4040
5. Create a document in Word and save it with the name **RibbonSample.docm**.
41-
41+
4242
6. Open the Visual Basic Editor, and add the following procedure to the **ThisDocument** code module. Close and save the document.
43-
43+
4444
```vb
4545
Sub InsertCompanyName(ByVal control As IRibbonControl)
4646
' Inserts the specified text at the beginning of a range or selection.
@@ -58,29 +58,29 @@ The code example in this topic shows how to add custom components to the ribbon
5858
```
5959

6060
7. Add a **.zip** extension to the document file name and then double-click it to open the file.
61-
61+
6262
8. Add the customization file to the container by dragging the customUI folder from the desktop to the .zip file.
63-
63+
6464
9. Extract the **.rels** file to your desktop. A **_rels** folder that contains the .rels file is copied to your desktop.
65-
65+
6666
10. Open the **.rels** file and add the following line between the last **Relationship** tag and the **Relationships** tag. This creates a relationship between the document file and the customization file.
67-
67+
6868
```xml
6969
<Relationship Id="someID" Type="http://schemas.microsoft.com/office/2006/relationships/ui/extensibility" Target="customUI/customUI.xml" />
7070
```
7171

7272
11. Close and save the file.
73-
73+
7474
12. Add the **.rels** folder back to the container file by dragging it from the desktop, overwriting the existing file.
75-
75+
7676
13. Rename the document file to its original name by removing the .zip extension.
77-
77+
7878
14. Open the document and notice that the ribbon now displays the **My Tab** tab.
79-
79+
8080
15. Choose the tab and notice the **Sample Group** group with a button control.
81-
81+
8282
16. Choose the button to insert the company name into the document.
83-
83+
8484
## See also
8585

8686
- [Overview of the Office Fluent ribbon](overview-of-the-office-fluent-ribbon.md)

Library-Reference/Concepts/getting-started-with-vba-in-office.md

+30-34
Large diffs are not rendered by default.

Library-Reference/Concepts/how-autosave-impacts-addins-and-macros.md

+8-8
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ ms.localizationpriority: medium
77

88
# How AutoSave impacts add-ins and macros
99

10-
Learn about how AutoSave works in Excel, PowerPoint, and Word, and how it can impact add-ins or macros.
10+
Learn about how AutoSave works in Excel, PowerPoint, and Word, and how it can impact add-ins or macros.
1111

1212
## Overview of AutoSave
1313

@@ -48,17 +48,17 @@ You may need to handle one or more of the following issues regarding the interac
4848

4949
### Issue 1: Code in BeforeSave or AfterSave events runs too long
5050

51-
In general, Word, Excel and PowerPoint are not responsive to user interaction while add-in or macro code is being run. Therefore, if your code in a **BeforeSave** or **AfterSave** event handler takes too long to run, it may significantly degrade the user experience.
51+
In general, Word, Excel and PowerPoint are not responsive to user interaction while add-in or macro code is being run. Therefore, if your code in a **BeforeSave** or **AfterSave** event handler takes too long to run, it may significantly degrade the user experience.
5252

53-
When AutoSave is disabled, this code is only run when the user explicitly chooses to save, so a delay is not as noticeable and can be avoided by the user until he or she is ready to save.
53+
When AutoSave is disabled, this code is only run when the user explicitly chooses to save, so a delay is not as noticeable and can be avoided by the user until he or she is ready to save.
5454

5555
When AutoSave is enabled, this code runs automatically on a periodic basis, which has the potential to interrupt the user, especially if the code takes a long time.
5656

5757
#### Example scenario
5858

59-
Imagine an add-in that allows the user to create custom maps based on data in an Excel workbook. Such an add-in might have **BeforeSave** code that serializes any maps that the user has created and stores them in the workbook in a CustomXML part. This process might take a second to complete, and Excel could be unresponsive while this is happening.
59+
Imagine an add-in that allows the user to create custom maps based on data in an Excel workbook. Such an add-in might have **BeforeSave** code that serializes any maps that the user has created and stores them in the workbook in a CustomXML part. This process might take a second to complete, and Excel could be unresponsive while this is happening.
6060

61-
When AutoSave is off, the user gets to choose when he or she wants to save, and therefore, even though the add-in slows down the save process slightly, the user does not notice.
61+
When AutoSave is off, the user gets to choose when he or she wants to save, and therefore, even though the add-in slows down the save process slightly, the user does not notice.
6262

6363
When AutoSave is enabled, this **BeforeSave** code runs automatically on a periodic basis even if the user is in the middle of something else (such as typing data into a cell), which could be extremely annoying.
6464

@@ -97,14 +97,14 @@ An add-in might have code that runs in response to the **BeforeSave** event that
9797
Consider removing code that writes to the workbook in **BeforeSave** or **AfterSave** events. For example, the add-in described in the example scenario might be modified to store the change log in a separate file or database.
9898

9999
<a name="Issue4"></a>
100-
100+
101101
### Issue 4: Code in **AfterSave** dirties the workbook (Excel only)
102102

103103
When AutoSave is on, the **BeforeSave** and **AfterSave** events will only trigger if there has been a change in the workbook since the last time they were triggered. If code in the **AfterSave** event dirties the workbook (that is, makes additional changes), that could potentially trigger events to fire again for the same change, and then queue up the events to fire again indefinitely. This could waste system resources and affect battery life.
104104

105105
#### Workaround
106106

107-
Code that dirties the workbook in **AfterSave** should be moved to **BeforeSave** or to another location entirely (see [Issue 3](#Issue3)). This isn't a good practice today, even without AutoSave, because it leaves the workbook in a perpetual "dirty" state, which causes a prompt to appear on close that asks the user to save their changes even if they made no additional changes. 
107+
Code that dirties the workbook in **AfterSave** should be moved to **BeforeSave** or to another location entirely (see [Issue 3](#Issue3)). This isn't a good practice today, even without AutoSave, because it leaves the workbook in a perpetual "dirty" state, which causes a prompt to appear on close that asks the user to save their changes even if they made no additional changes.
108108

109109
<a name="Issue5"></a>
110110

@@ -118,7 +118,7 @@ Private Sub Workbook_BeforeSave(ByVal SaveAsUI As Boolean, Cancel As Boolean) 
118118
End Sub
119119
```
120120

121-
When AutoSave is enabled, the application (that is, Excel, Word, or PowerPoint) triggers saves automatically on a continuous basis until the file has no more unsaved changes. After the user makes a single change to the file, the application attempts to save it.
121+
When AutoSave is enabled, the application (that is, Excel, Word, or PowerPoint) triggers saves automatically on a continuous basis until the file has no more unsaved changes. After the user makes a single change to the file, the application attempts to save it.
122122

123123
If the developer chooses to cancel the save in the manner described earlier, the application continually determines that there are unsaved changes, which causes the save to (eventually) be attempted again. Because the same event code that cancelled the first save will also cancel this second save attempt, the process will continue for as long as the file is open, potentially degrading performance and battery life.
124124

Library-Reference/Concepts/using-the-document-inspector.md

+26-26
Original file line numberDiff line numberDiff line change
@@ -10,10 +10,10 @@ ms.localizationpriority: medium
1010

1111
The **Document Inspector** gives users an easy way to examine documents for personal or sensitive information, text phrases, and other document contents. For example, before distributing a document, they can use the **Document Inspector** to remove unwanted information.
1212

13-
> [!NOTE]
13+
> [!NOTE]
1414
> Microsoft does not support the automatic removal of hidden information for signed or protected documents, or for documents that use Information Rights Management (IRM). We recommend that you run the **Document Inspector** before you sign a document or invoke IRM on a document.
1515
16-
As a developer, you can use the Document Inspector framework to extend the built-in modules and integrate your extensions into the standard user interface.
16+
As a developer, you can use the Document Inspector framework to extend the built-in modules and integrate your extensions into the standard user interface.
1717

1818
The **Document Inspector** in Word, Excel, and PowerPoint includes the following enhancements.
1919

@@ -23,45 +23,45 @@ The **Document Inspector** has modules that help users inspect and fix specific
2323

2424
### For all Office documents
2525

26-
- Embedded documents
27-
- OLE objects and packages
28-
- Data models
29-
- Content apps
30-
- Task Pane apps
26+
- Embedded documents
27+
- OLE objects and packages
28+
- Data models
29+
- Content apps
30+
- Task Pane apps
3131
- Macros and VBA modules
3232
- Legacy macros (XLM and WordBasic)
33-
33+
3434
### For Excel documents
3535

36-
- PivotTables and slicers
36+
- PivotTables and slicers
3737
- PivotCharts
3838
- Cube formulas
3939
- Timelines (cache)
4040
- Custom XML data
4141
- Comments and annotations
4242
- Document properties and personal information
4343
- Headers and footers
44-
- Hidden rows and columns
45-
- Hidden worksheets and names
46-
- Invisible content
47-
- External links and data functions
48-
- Excel surveys
44+
- Hidden rows and columns
45+
- Hidden worksheets and names
46+
- Invisible content
47+
- External links and data functions
48+
- Excel surveys
4949
- Custom worksheet properties
50-
50+
5151
### For PowerPoint documents
5252

53-
- Comments and annotations
54-
- Document properties and personal information
55-
- Invisible on-slide content
56-
- Off-slide content
53+
- Comments and annotations
54+
- Document properties and personal information
55+
- Invisible on-slide content
56+
- Off-slide content
5757
- Presentation notes
58-
58+
5959
### For Word documents
6060

61-
- Comments, revisions, versions, and annotations
61+
- Comments, revisions, versions, and annotations
6262
- Document properties and personal information; this includes metadata, SharePoint properties, custom properties, and other content information
63-
- Custom XML data
64-
- Headers, footers, and watermarks
63+
- Custom XML data
64+
- Headers, footers, and watermarks
6565
- Invisible content
6666
- Hidden text
6767

@@ -70,11 +70,11 @@ The **Document Inspector** has modules that help users inspect and fix specific
7070
To open the **Document Inspector**:
7171

7272
1. Choose the **File** tab, and then choose **Info**.
73-
73+
7474
2. Choose **Check for Issues**.
75-
75+
7676
3. Choose **Inspect Document**.
77-
77+
7878
Use the **Document Inspector** dialog box to select the type or types of data to find in the document.
7979

8080
After the modules complete the inspection, the **Document Inspector** displays the results for each module in a dialog box. If a given module finds data, the dialog box includes a **Remove All** button that you can click to remove that data. If the module does not find data, the dialog box displays a message to that effect.

outlook/Concepts/Specifying-Form-Behavior/add-a-control-to-a-form.md

+7-8
Original file line numberDiff line numberDiff line change
@@ -10,16 +10,15 @@ ms.localizationpriority: medium
1010

1111
Use this procedure to add a control from the [Control Toolbox](../Customizing-Forms/control-toolbox-overview.md) to your form. You can also use this procedure to insert a control in a **[Frame](../../../api/Outlook.frame.md)**, **[TabStrip](../../../api/Outlook.tabstrip.md)**, or **[MultiPage](../../../api/Outlook.multipage.md)** on the form.
1212

13-
1413
1. In an open form on the **Developer** tab, in the **Tools** group, click **Control Toolbox**.
15-
14+
1615
**Note** f you don't see the **Developer** tab in the open form, see the topic [Run in Developer Mode in Outlook](../../How-to/Using-Visual-Basic-to-Customize-Outlook-Forms/run-in-developer-mode-in-outlook.md).
1716
2. Do one of the following:
18-
19-
- Click a control in the **Control Toolbox** and then click in the form. The control appears in its default size. You can then drag the border of the control to change its size.
20-
21-
- Drag a control from the **Control Toolbox** to the form. The control appears in its default size.
22-
23-
- Double-click the control in the **Control Toolbox**, and then click in the form once for each control that you want to create. For example, to create four command buttons, double-click the [CommandButton](../../../api/Outlook.commandbutton.md) control in the **Control Toolbox**, and then click four times in the form.
17+
18+
- Click a control in the **Control Toolbox** and then click in the form. The control appears in its default size. You can then drag the border of the control to change its size.
19+
20+
- Drag a control from the **Control Toolbox** to the form. The control appears in its default size.
21+
22+
- Double-click the control in the **Control Toolbox**, and then click in the form once for each control that you want to create. For example, to create four command buttons, double-click the [CommandButton](../../../api/Outlook.commandbutton.md) control in the **Control Toolbox**, and then click four times in the form.
2423

2524
[!include[Support and feedback](~/includes/feedback-boilerplate.md)]

outlook/Concepts/Specifying-Form-Behavior/add-a-modified-control-to-the-control-toolbox.md

+8-12
Original file line numberDiff line numberDiff line change
@@ -8,17 +8,13 @@ ms.localizationpriority: medium
88

99
# Add a Modified Control to the Control Toolbox
1010

11-
1. In an open form on the **Developer** tab, in the **Tools** group, click
12-
![Control Toolbox icon](../../../images/0548_ZA06045100.gif) **Control Toolbox**.
13-
14-
**Note** If you don't see the **Developer** tab in the open form, see the topic [Run in Developer Mode in Outlook](../../How-to/Using-Visual-Basic-to-Customize-Outlook-Forms/run-in-developer-mode-in-outlook.md).
15-
2. Drag a control from the **Control Toolbox** to your form and customize it. For example, to create an **OK** button, drag a **CommandButton** control onto the form, set its **Caption** property to **OK**, and set its **Default** property to **True**.
16-
17-
3. Select the customized control.
18-
19-
4. Drag the control to the **Control Toolbox**.
20-
11+
1. In an open form on the **Developer** tab, in the **Tools** group, select **Control Toolbox**.
12+
![Control Toolbox icon](../../../images/0548_ZA06045100.gif)
13+
**Note** If you don't see the **Developer** tab in the open form, see the [Run in Developer Mode in Outlook](../../How-to/Using-Visual-Basic-to-Customize-Outlook-Forms/run-in-developer-mode-in-outlook.md).
14+
1. Drag a control from the **Control Toolbox** to your form and customize it. For example, to create an **OK** button, drag a **CommandButton** control onto the form, set its **Caption** property to **OK**, and set its **Default** property to **True**.
15+
1. Select the customized control.
16+
1. Drag the control to the **Control Toolbox**.
2117

22-
**Note** When you drag a control onto the **Control Toolbox**, you only transfer the advanced property values. Any lines of code or Outlook property values that you have written for that control don't transfer with the control. You must write new code or copy code from the control on the form to the control on the **Control Toolbox**.
18+
**Note** When you drag a control onto the **Control Toolbox**, you only transfer the advanced property values. Any lines of code or Outlook property values that you have written for that control don't transfer with the control. You must write new code or copy code from the control on the form to the control on the **Control Toolbox**.
2319

24-
[!include[Support and feedback](~/includes/feedback-boilerplate.md)]
20+
[!include[Support and feedback](~/includes/feedback-boilerplate.md)]

outlook/Concepts/Specifying-Form-Behavior/add-items-to-a-list-in-design-mode.md

+4-4
Original file line numberDiff line numberDiff line change
@@ -9,11 +9,11 @@ ms.localizationpriority: medium
99
# Add Items to a List in Design Mode
1010

1111
1. In Forms Designer, drag the **[ListBox](../../../api/Outlook.listbox.md)** or **[ComboBox](../../../api/Outlook.combobox.md)** control from the [Control Toolbox](show-or-hide-the-control-toolbox.md) to the form.
12-
12+
1313
2. Right-click the control, then click **Properties** on the shortcut menu.
14-
14+
1515
3. In the **Properties** dialog box, on the **Value** tab, click **Choose Field**, point to the **User-defined** field set, and then click the custom field to which you want the control bound.
16-
16+
1717
4. In the **Possible values** box, type the values for the items that you want to appear in the list, separated by semicolons.
1818

19-
[!include[Support and feedback](~/includes/feedback-boilerplate.md)]
19+
[!include[Support and feedback](~/includes/feedback-boilerplate.md)]

outlook/Concepts/Specifying-Form-Behavior/add-other-custom-controls-to-the-control-toolbox.md

+3-6
Original file line numberDiff line numberDiff line change
@@ -8,13 +8,10 @@ ms.localizationpriority: medium
88

99
# Add Other Custom Controls to the Control Toolbox
1010

11-
12-
13-
1411
1. In Forms Designer, on the **Developer** tab, in the **Tools** group, click [Control Toolbox](../Customizing-Forms/control-toolbox-overview.md).
15-
12+
1613
2. Right-click any control or an empty area on any page of the **Control Toolbox**, and then click **Custom Controls** on the shortcut menu.
17-
14+
1815
3. In the **Available Controls** box, select the check box next to the controls that you want to add.
1916

20-
[!include[Support and feedback](~/includes/feedback-boilerplate.md)]
17+
[!include[Support and feedback](~/includes/feedback-boilerplate.md)]

outlook/Concepts/Specifying-Form-Behavior/adding-items-to-a-list.md

+3-4
Original file line numberDiff line numberDiff line change
@@ -8,15 +8,14 @@ ms.localizationpriority: medium
88

99
# Adding Items to a List
1010

11-
You can add items to a list box or a combo box at design time or at run time.
11+
You can add items to a list box or a combo box at design time or at run time.
1212

1313
To save contents in an item, **[ListBox](../../../api/Outlook.listbox.md)** and **[ComboBox](../../../api/Outlook.combobox.md)** controls must be bound to a field.
1414

1515
For more information, see the following topics:
1616

17-
1817
- [How to: Add Items to a List at Design Time](add-items-to-a-list-in-design-mode.md)
19-
18+
2019
- [How to: Add Items to a List at Run Time](../../How-to/General/how-to-add-items-to-a-list-or-combo-box-at-run-time.md)
2120

22-
[!include[Support and feedback](~/includes/feedback-boilerplate.md)]
21+
[!include[Support and feedback](~/includes/feedback-boilerplate.md)]

0 commit comments

Comments
 (0)