Office Button.

Transcription

1 Office Button How to Add Office Button to the ToolBox... 2 How to Add Office Button Binary to Projects... 2 How to Add Office Button Source Code to Projects... 2 Supported Properties... 3 Drawing Sequence... 4 Frequently Asked Questions (F.A.Q.)... 5

2 How to Add Office Button to the ToolBox The following steps will add Office Button to the Visual Studio ToolBox: 1. Open the ToolBox (View > ToolBox) 2. Right Click and select Choose Items 3. In the dialog, under the tab.net Framework Components find OfficeButton in the list of components. 4. If OfficeButton does not appear on the list, click the button Browse and find OfficeButton.dll in the installation folder (Program Files\Visual C# Kicks\OfficeButton\Binary by default) 5. Make sure the checkbox in the list is checked and click OK How to Add Office Button Binary to Projects On any given project, follow these steps: 1. Go to the Project menu 2. Select Add Reference 3. In the Add Reference dialog, under the.net tab, scroll down to find OfficeButton. Select it and choose OK The OfficeButton class will now be available to use within the project How to Add Office Button Source Code to Projects Note: The source code must have been purchased for it to be available. On any given project, follow these steps: 1. Go to the Solution Explorer 2. Go to Add > Existing Project 3. Navigate to the Office Button installation folder (Program Files\Visual C# Kicks\OfficeButton\Source Code\OfficeButton by default) 4. Select OfficeButton.csproj Note: It is recommended to make a copy of the entire source code folder and reference the copied project instead.

3 Supported Properties Office Button supports a variety of properties that can be broken down into three categories. One category includes properties inherited and handled by the base System.Windows.Forms.Button class. The second category includes properties inherited by the Button class, but that required specific implementation (available in the Office Button source code). Finally the third category consists of properties unique to the Office Button component. Below is a list of Button properties implemented in the Office Button component (i.e. category two properties): BackgroundImage BackgroundImageLayout Image ImageAlign TextImageRelation Below is a comprehensive overview of the properties that are unique to Office Button (i.e. category three properties): BaseColorHue Gets or sets the base color which determines the hue of the component s color scheme. Used to colorize the Office Button. KeepHightlightColor Gets or sets whether the component s highlighted color scheme is affected by the BaseColorHue property. If true, the default highlight color scheme is used independent of the BaseColorHue property.

4 Drawing Sequence PaintButtonNormal PaintButtonHover PaintButtonDown PaintButtonFocused PaintButtonDefault PaintButton DrawBackgroundImage DrawForeground fire Paint event

5 Frequently Asked Questions (F.A.Q.) What language was Office Button written in? Office Button was written in C#.NET 2.0. As such, the component will run on.net Framework 2.0 and up. The source code solution was saved under Visual Studio How do I change the colors of Office Button? Office Button automatically builds a color scheme based on the BaseColorHue property. In essence the hue of the BaseColorHue color is applied to a predetermined set of colors. The control does not do everything I want it to. How do I modify it if I don t have the source code? The short answer is to create a new user control that inherits the OfficeButton class. OfficeButton was designed to make both subtle and drastic modifications easy by overriding functions. Unlike the default.net Button for example, OfficeButton has clearly defined functions that handle drawing different elements of the component. Modifying certain functions allows for customization without forcing developers to re implement existing functionality. Why is the KeepHightlightColor property included? The KeepHighlightColor property is intended to give developers flexibility when applying different color hues to an Office Button. By setting the property to true, developers can isolate the color hue modifications to the normal states of an Office Button. On the other hand, setting the property to false allows Office Button to apply the hue transformation to the highlight state as well. There is a lot of source code, what s the easiest way to browse through all of it? The source code is organized using code regions. Code regions can be used to hide and show sections of code. Here are some helpful shortcuts in Visual Studio: Ctrl+M, Ctrl+M expands/collapses the current region block Ctrl+M, Ctrl+O collapses all the region blocks in the current source code file Ctrl+M, Ctrl+L expands all the region blocks in the current source code file I found a bug, what should I do? You can report any bugs to Visual C# Kicks at support@vcskicks.com. We will do our best to include all bug fixes in future releases of Office Button.