Starter Kit: Crusader
Introduction
Getting Started
Files
Game Development Concepts
Extending the game
For More Information
Introduction
Welcome to the Upgrade your Game series of tutorials. There will be 3 tutorials each covering writing a simple computer game using Visual Studio Express products. Though the games are simple, each one will teach some game development techniques and each will build on the last to improve your skills. The skills can be applied to more complex games including 3D games using Microsoft DirectX.
Not all games are real time action games. Role playing games (RPGs) are generally slower paced with more thinking and usally no penalty if you turn your attention to something else for a few moments. Many, many, many years ago, sometime in the 1970s RPGs were played using text or graphics made up from text. Since this is not the 1970s we can do a little better than that using the sprites from the previous games.
For the third and final game I will be creating a tile based role playing game. These days role playing games have as good graphics and special effects as any first person shooter. But the origins of graphical role playing games are tile based games like the early Final Fantasy and Ultima games. Since this is a beginner series with limited code I cannot create even games as complex as those early works, however I can give you most of the techniques you will need to put together similar looking games. After that its really just up to your imagination.
Note: This documentation assumes that you have a basic knowledge of programming concepts and the Visual C# environment. You can learn more about these topics in the product documentation by clicking Help on the Main Menu, and selecting Contents, Index, or Search. You can also access Help by positioning the mouse cursor on language keywords or user interface elements such as windows or dialog boxes, and pressing F1.
Getting Started
Building and running Crusader
Once your project is loaded into the Visual C# environment, you can compile and run the program in one step.
To build and run Crusader
- Press F5 to build and start the game under the debugger.
The game launches and you can control the hero using the arrow keys and P to use magic potions. Find the keys to open the doors and kill the wizard who has captured the princess.
Files
| File | Use |
| Area.cs | Represents an 8x8 area of the world. Each area store a set of tiles and current state of any dynamic objects. In addition it stores conenctiviy information about which areas surround it. |
| BitmapCache.cs | A static class that stores bitmaps in a cache. This is used by the sprite class to save on memory and loading time by reuseing bitmaps. |
| Crusader.cs | The main display form. Other than UI initialization and keyboard events little game play code is performed in here. Most code calls into GameState |
| GameObject.cs | Abstract base class that represents an object that requires updating and drawing once per frame |
| GameState.cs | Stores the current state of the game and controls all gameplay |
| MapTile.cs | Stores an individual tile. Each tile has a background sprite and an optional foreground, transparent, sprite. In addition for dynamic sprites like monsters we store the current stte of tht monster. e.g. Health |
| Sounds.cs | A static class that plays any of the game sounds. |
| Tile.cs | Represents a tile from the data file. |
| World.cs | The world is a collection of Areas. This class handles reading of the the tile and map files and any gameplay related to the world. |
Game Development Concepts
If you are new to 2d game development then check out the 2d Game Develoment primer.
Tile based Games
Tile based games get their name from the way the graphics are built up. Instead of having a single graphic for each area in the game the area is built up from several small tiles. So there is a tile for grass, another with a tree and another with a brick wall. By combining these squares like a patchwork quilt you can make a huge number of different looking levels from a small number of graphics. Take a look at the tiles.bmp in the GameData folder for an idea what the tiles look like for this game.
For this game I asked the artist to cover 3 themes:
- Outdoor - grass, trees and paths
- Castles - walls, floor and decorations
- Dungeon - different walls and floor
For the paths I asked him to create all the sections needed to make paths that connect in any direction. This means there are 11 different combinations for each one. In addition he created 3 doors of differing colors with both open and closed positions. The doors are themed to fit into the castle wall.
You will also see that this file also includes tiles for all of the in game objects. These are not drawn as part of the tile based background but instead are layered over the top of the tiles depending on the location of the item in the game.
Extracting sprites and animation from sprite sheets
Its far more efficient to load all of the graphics in one go rather then having many different files as I did in Space Blitz. As you have already seen the graphics for this game are all in one file. Well actually they are in two. I asked the artist to put the multiframe animations in a second file so that we could control the layout without having to fit them around the other tiles. Take a look at animations.bmp if you are interested.
The sprite class currently loads its own bitmap given a file name which is not really very efficient either - in Space Blitz you loaded the same bitmap multiple times each time it was used. To improve this I added a constructor that takes an already loaded bitmap and just stores the reference to it. Now multiple sprites can share the same bitmap. This doesn't make sense for sprites that you want to change like to bases in Space Blitz but those are the exception to the rule.
So how does the Sprite know which bit of the large bitmap it should draw? In the same constructor you pass a Rectangle structure that describes the top, left, height and width of the region you wish to extract. When the sprite is drawn it uses this to draw only the relevant part. The function also takes the number of frames of animation within that rectangle and automatically subdivides the rectangles to extract the correct frame into the _frames collection
public Sprite(GameState gameState, float x, float y, Bitmap bitmap, Rectangle rectangle, int numberAnimationFrames)
{
for (int i = 0; i < numberAnimationFrames; i++)
{
_frames.Add(bitmap);
//Set the location and use the height and width from the 1st frame
initialize(gameState, x, y, rectangle.Width / numberAnimationFrames, rectangle.Height);
_rectangle.Add(new Rectangle(rectangle.X + i * rectangle.Width / numberAnimationFrames, rectangle.Y,
rectangle.Width / numberAnimationFrames, rectangle.Height));
}
}
public override void Draw(Graphics graphics)
{
graphics.DrawImage(_frames[CurrentFrame], outputRect,
_rectangle[CurrentFrame].X, _rectangle[CurrentFrame].Y,
_rectangle[CurrentFrame].Width, _rectangle[CurrentFrame].Height,
GraphicsUnit.Pixel);
}
Using color key to make sprites transparent
If the game objects were drawn over the top of the tiles in the same way that all of the other sprites are drawn they would look like this:
In Space Blitz all of the aliens were actually being drawn inside a black box (try changing the form background color and running the game). Since the game background was black you could not see this. That was fine for Space Blitz but is obviously not suitable for Crusader. The technique used is called Color Key and is the same one used in movies to put actors in front of a green screen into a sci-fi setting. Its more often called chroma key. The general idea is that you do not draw a pixel where it is a certain color. I requested the artist choose an RGB color that he was not using in the artwork and set the backgrounds to that color. He chose (75, 75, 75) which is the dark grey you see in the image above. When you ask GDI to draw the shape you tell it which color to remove and all the magic is done for you giving this corrected image:
The code is just a few lines of modification to the sprite drawing routine. _colorKey is Color.ToArgb(75, 75, 75).
//Set the color key for this sprite;
_attributes= new ImageAttributes();
_attributes.SetColorKey(_colorKey, _colorKey);
....
graphics.DrawImage(_frames[CurrentFrame], outputRect,
_rectangle[CurrentFrame].X, _rectangle[CurrentFrame].Y,
_rectangle[CurrentFrame].Width, _rectangle[CurrentFrame].Height,
GraphicsUnit.Pixel, _attributes);
Data Driven Map Architecture
Describing what goes where in a game like this makes much more sense to be in a data file than inside the code. This means that some aspects of the game are very easy for you to change without even recompiling.
There are 2 data files that drive most of the look and feel of the game. Things like how the doors open, how the monsters fight and what happens when you pick things up are, for this sample, hard coded in the code. But there's no reason why you couldn't change the data files to make them even more descriptive and then drive the game from the new files. You will be able to debate file formats and how they are laid out forever, so find something that works for your game and stick to it. To keep down the amount of code there error checking is minimal. For a game that is deigned to be modded by the end users this is something that would have to be improved.
Tilelookups.csv
This file describes all of the tiles and sprites in the game. Its a comma delimited format that contains the following information:
Name: text name of the item
Shortcut: an abbreviated lookup. This value must be unique and for background tiles must be a single character
Path to bitmap: which bitmap this tile comes from
X: the x count into the tile sheet. 1 is the 1st column. Assumes that the tiles are all the same size.
Y: the y count into the tile sheet. 1 is the 1st row. Assumes that the tiles are all the same size.
Transparent: Y or N (not case sensitive). if Y the (75, 75, 75) will be color keyed out.
Number of Frames: How many frames of animation. The frames must be laid out from left to right with X,Y being frame 0
Traversable: Open or Block (not case sensitive). If Block then the hero cannot pass.
Special: For doors and keys this is the color, for characters is is the default health.
Example
DoorGreenOpen,G,Door,gamedata\tiles.bmp,5,1,N,1,Open,Green
Map.txt
This file describes the set if 8x8 areas that make up the world. There is a single blank line between each area.
line1: Name of the area - must be unique
line2: Which area you move to when you go North or -
line3: Which area you move to when you go East or -
line4: Which area you move to when you go South or -
line5: Which area you move to when you go West or -
lines6-13: an 8x8 grid made up of the shortcut characters from tilelookups.csv
lines 13 onwards: x,y,shortcut. A list of objects and their x,y position in the area. x and y are zero based.
final blank line:
Example
start - bezdroza - - >>>>>>>> >.>..... >...^... >....ccc ^.^..... ^^...... >..>.... >>^>>>>> 1,1,kbr 1,6,pot 3,1,arm 4,1,att 4,6,tro 5,6,tro 6,6,tro
Character Development and Game Play
One thing that distinguishes RPGs from other kinds of games is that usually the story is very relevant to the plot rather than being a poor excuse for why the character is about to do something very unlikely. In addition you usually take the character from a low start point to some high point in the game by changing or improving the way that character works. Different games call them different things but you have probably heard of games with levels, hit points, strength, agility and many more. The more advanced the game gets the more of these there are to track and the more effect they have in different parts of the game.
Given the limited space for these games I chose to have a very simple, but often heard, story. The princess has been captured by the forces of evil (in this case a wizard since that's what the artist drew) and it is your job to rescue her. The story plays plays out in 3 settings: an outdoor area, a dungeon and a castle and each has a distinct look and type of monster to fight.
The characters attributes are:
- health, which should stay above 0 and are replenished by food items
- experience, which is earned by killing monsters and gives attack and armour bonuses at certain levels
- attack rating - increases your damage and ability to hit
- armour rating - decreases the ability of others to hit you
- potions - each potion does damage to all visible monsters
- keys - which ones are you holding
All of these attributes and the code to manipulate them can be found in the GameState or the World classes. There is too much to list here but spend some time looking through to see how the world works. Searching for 'Health' for example will show you all the places that the health points are increased or decreased.
Extending Crusader
- Since most of the game is data driven open up the maps in notepad and make some of your own
- Change all of the graphics to make a space themed game
- Game too hard or too easy? Change the rules of the game in the code. Give each monster its own attack and armour rating. Let the monsters attack back with magic.
- Make the monsters move toward you. You should be able to reuse some of the hero animation code but you will need to implement some path finding algorithms to avoid obstacles.
For More Information
Online Resources
- Discuss this Starter Kit in Channel9's TechOff forum
- Provide feedback on this documentation
- Game Development on Coding4Fun
© Microsoft Corporation and/or its suppliers. All rights reserved. Terms of Use.


RUSH HOUR 2 A film review by Steve Rhodes Copyright 2001 Steve Rhodes RATING (0 TO ****): ** 1/2
The problem with movies like RUSH HOUR 2 that give away almost all of the good jokes in the trailers is that seeing the movie itself is about as much fun as watching reruns. In RUSH HOUR 2, this problem is further compounded by the lack of freshness in the jokes themselves. How many times have we heard the one about the two guys who keeping misunderstanding each other as when one says a woman "is da bomb" and the other thinks that the woman "has the bomb?"
The movie's almost saving grace is that it stars that teddy bear of a martial arts comedic hero, Jackie Chan. Actually, he refers to himself in the movie as a Snoopy character that women love. And women, if you do have a thing for Jackie, you'll be glad to know that you'll get a chance to catch a glimpse of his naked buttocks this time. Blink, and you'll miss it.
As they did in the original, Chan, as Hong Kong Detective Inspector Lee, teams up with Chris Tucker, as LAPD Detective James Carter. They have good chemistry together even if Tucker keeps trying to upstage Chan. Lee and Carter are best when they are the most surprised, as they are when they go to a gay haberdasher (Jeremy Piven) to get outfitted in the finest silks. But, if you've seen the trailers, you already know the joke.
The setup this time, to the extent that one is needed in a Chan movie, concerns the thwarting of an international counterfeiting ring. John Lone (THE LAST EMPEROR) and Zhang Ziyi (CROUCHING TIGER, HIDDEN DRAGON) play the villains. Roselyn Sanchez plays a big bosomed woman who may or may not be a secret service agent hot on the trail of the cash and the printing plates. Don Cheadle has a cameo that works best in the outtakes, just about always the best part of any Chan film anyway.
As always, Chan is lovable, funny and vulnerable. Unlike most action heroes, his pain is palpable. Working from an unimaginative script by Ross LaManna, director Brett Ratner is never able to get the pacing right, with long slack sections slowing the momentum between funny moments. In the movies today, all roads lead to Las Vegas, where the neon glitters and all of the buildings are little more than movie sets for adults. RUSH HOUR 2 ends there in a burst of glory that hints at what could have been if the rest of the movie were better written and more tightly paced.
RUSH HOUR 2 runs 1:30. It is rated PG-13 for action violence, language and some sexual material and would be acceptable for kids around 8 and up.
My son Jeffrey and his friend Sam, both age 12, gave the movie *** 1/2 and ***, respectively. They both thought that it was funny and had well planned out laughs.
The film opens nationwide in the United States on Friday, August 3, 2001. In the Silicon Valley it will be showing at the AMC and the Century theaters.
Web: http://www.InternetReviews.com Email<EMAIL_ADDRESS>Want free reviews and weekly movie and video recommendations via Email? Just send me a letter with the word "subscribe" in the subject line.
========== X-RAMR-ID: 29026 X-Language: en X-RT-ReviewID: 241701 X-RT-TitleID: 1109232 X-RT-SourceID: 703 X-RT-AuthorID: 1271 X-RT-RatingText: 2.5
The review above was posted to the
rec.arts.movies.reviews newsgroup (de.rec.film.kritiken for German reviews).
The Internet Movie Database accepts no responsibility for the contents of the
review and has no editorial control. Unless stated otherwise, the copyright
belongs to the author.
Please direct comments/criticisms of the review to relevant newsgroups.
Broken URLs inthe reviews are the responsibility of the author.
The formatting of the review is likely to differ from the original due
to ASCII to HTML conversion.
Related links: index of all rec.arts.movies.reviews reviews


A graduate of RIT's Game Design and Development program, as well as a student at Warren Spector's Denius-Sams Gaming Academy, Kathleen loves working on big teams creating great games. An eSports enthusiast, craft beer lover, hardcore gamer, and yours to hire!


| Order | Name | Type |
| Return | transactionRef | string |
| Input 1 | transactionRef | string |
| Input 2 | note | string |
| 1) | This method will reverse a transaction (i.e. create a copy of the transaction with an inverse amount) and add this new transaction to the journal of the original transaction's owner. The new transaction is called the reversal and the original is considered the reversed. |
| 2) | A soap fault will occur if the parameter transactionRef is empty or invalid. |
| 3) | The note provided will be added to the note field of the newly created transaction. |
| 4) | The following transaction types cannot be reversed: RecurringGiftSchedule and SoftCredit. Needless to say, reversed or reversal transactions cannot be reversed. |


Refs provide a way to access DOM nodes or React elements created in the render method.
 To modify a child, you re-render it with new props. However, there are a few cases where you need to imperatively modify a child outside of the typical dataflow. The child to be modified could be an instance of a React component, or it could be a DOM element. For both of these cases, React provides an escape hatch.
There are a few good use cases for refs:
Avoid using refs for anything that can be done declaratively.
For example, instead of exposing open()
and close()
methods on a Dialog
component, pass an isOpen
prop to it.
Your first inclination may be to use refs to "make things happen" in your app. If this is the case, take a moment and think more critically about where state should be owned in the component hierarchy. Often, it becomes clear that the proper place to "own" that state is at a higher level in the hierarchy. See the Lifting State Up guide for examples of this.
Note
The examples below have been updated to use the
React.createRef()
API introduced in React 16.3. If you are using an earlier release of React, we recommend using callback refs instead.
Refs are created using React.createRef()
and attached to React elements via the ref
attribute. Refs are commonly assigned to an instance property when a component is constructed so they can be referenced throughout the component.
class MyComponent extends React.Component {
constructor(props) {
super(props);
this.myRef = React.createRef();
}
render() {
return
;
}
}
When a ref is passed to an element in render
, a reference to the node becomes accessible at the current
attribute of the ref.
The value of the ref differs depending on the type of the node:
ref
attribute is used on an HTML element, the ref
created in the constructor with React.createRef()
receives the underlying DOM element as its current
property.ref
attribute is used on a custom class component, the ref
object receives the mounted instance of the component as its current
.ref
attribute on function components because they don't have
instances.The examples below demonstrate the differences.
This code uses a ref
to store a reference to a DOM node:
class CustomTextInput extends React.Component {
constructor(props) {
super(props);
// create a ref to store the textInput DOM element
this.textInput = React.createRef();
this.focusTextInput = this.focusTextInput.bind(this);
}
focusTextInput() {
// Explicitly focus the text input using the raw DOM API
// Note: we're accessing "current" to get the DOM node
this.textInput.current.focus();
}
render() {
// tell React that we want to associate the <input> ref
// with the `textInput` that we created in the constructor
return (

<input
type="text"
ref={this.textInput} />
<input
type="button"
value="Focus the text input"
onClick={this.focusTextInput}
/>

);
}
}
React will assign the current
property with the DOM element when the component mounts, and assign it back to null
when it unmounts. ref
updates happen before componentDidMount
or componentDidUpdate
lifecycle methods.
If we wanted to wrap the CustomTextInput
above to simulate it being clicked immediately after mounting, we could use a ref to get access to the custom input and call its focusTextInput
method manually:
class AutoFocusTextInput extends React.Component {
constructor(props) {
super(props);
this.textInput = React.createRef();
}
componentDidMount() {
this.textInput.current.focusTextInput();
}
render() {
return (
<CustomTextInput ref={this.textInput} />
);
}
}
Note that this only works if CustomTextInput
is declared as a class:
class CustomTextInput extends React.Component {
// ...
}
By default, you may not use the ref
attribute on function components because they don't
have instances:
function MyFunctionComponent() {
return <input />;
}
class Parent extends React.Component {
constructor(props) {
super(props);
this.textInput = React.createRef();
}
render() {
// This will *not* work!
return (
<MyFunctionComponent ref={this.textInput} />
);
}
}
If you want to allow people to take a ref
to your function component, you can use forwardRef
(possibly in conjunction with useImperativeHandle
), or you can convert the component to a class.
You can, however, use the ref
attribute inside a function component as long as you refer to a DOM element or a class component:
function CustomTextInput(props) {
// textInput must be declared here so the ref can refer to it
const textInput = useRef(null);
function handleClick() {
textInput.current.focus();
}
return (

<input
type="text"
ref={textInput} />
<input
type="button"
value="Focus the text input"
onClick={handleClick}
/>

);
}
In rare cases, you might want to have access to a child's DOM node from a parent component. This is generally not recommended because it breaks component encapsulation, but it can occasionally be useful for triggering focus or measuring the size or position of a child DOM node.
While you could add a ref to the child component, this is not an ideal solution, as you would only get a component instance rather than a DOM node. Additionally, this wouldn't work with function components.
If you use React 16.3 or higher, we recommend to use ref forwarding for these cases. Ref forwarding lets components opt into exposing any child component's ref as their own. You can find a detailed example of how to expose a child's DOM node to a parent component in the ref forwarding documentation.
If you use React 16.2 or lower, or if you need more flexibility than provided by ref forwarding, you can use this alternative approach and explicitly pass a ref as a differently named prop.
When possible, we advise against exposing DOM nodes, but it can be a useful escape hatch. Note that this approach requires you to add some code to the child component. If you have absolutely no control over the child component implementation, your last option is to use findDOMNode()
, but it is discouraged and deprecated in StrictMode
.
React also supports another way to set refs called "callback refs", which gives more fine-grain control over when refs are set and unset.
Instead of passing a ref
attribute created by createRef()
, you pass a function. The function receives the React component instance or HTML DOM element as its argument, which can be stored and accessed elsewhere.
The example below implements a common pattern: using the ref
callback to store a reference to a DOM node in an instance property.
class CustomTextInput extends React.Component {
constructor(props) {
super(props);
this.textInput = null;
this.setTextInputRef = element => {
this.textInput = element;
};
this.focusTextInput = () => {
// Focus the text input using the raw DOM API
if (this.textInput) this.textInput.focus();
};
}
componentDidMount() {
// autofocus the input on mount
this.focusTextInput();
}
render() {
// Use the `ref` callback to store a reference to the text input DOM
// element in an instance field (for example, this.textInput).
return (

<input
type="text"
ref={this.setTextInputRef}
/>
<input
type="button"
value="Focus the text input"
onClick={this.focusTextInput}
/>

);
}
}
React will call the ref
callback with the DOM element when the component mounts, and call it with null
when it unmounts. Refs are guaranteed to be up-to-date before componentDidMount
or componentDidUpdate
fires.
You can pass callback refs between components like you can with object refs that were created with React.createRef()
.
function CustomTextInput(props) {
return (

<input ref={props.inputRef} />

);
}
class Parent extends React.Component {
render() {
return (
<CustomTextInput
inputRef={el => this.inputElement = el}
/>
);
}
}
In the example above, Parent
passes its ref callback as an inputRef
prop to the CustomTextInput
, and the CustomTextInput
passes the same function as a special ref
attribute to the <input>
. As a result, this.inputElement
in Parent
will be set to the DOM node corresponding to the <input>
element in the CustomTextInput
.
If you worked with React before, you might be familiar with an older API where the ref
attribute is a string, like "textInput"
, and the DOM node is accessed as this.refs.textInput
. We advise against it because string refs have some issues, are considered legacy, and are likely to be removed in one of the future releases.
Note
If you're currently using
this.refs.textInput
to access refs, we recommend using either the callback pattern or thecreateRef
API instead.
If the ref
callback is defined as an inline function, it will get called twice during updates, first
with null
and then again with the DOM element. This is because a new instance of the function is
created with each render, so React needs to clear the old ref and set up the new one. You can avoid this by defining
the ref
callback as a bound method on the class, but note that it shouldn't matter in most cases.


Hastings is an attractive fishing port lying on the western side of the large tidal bay in the Bass Strait, called Westernport.
It is a great mecca for serious fishermen. It is also a popular holiday spot for those who like the quiet life. It is approximately 50 miles south of Melbourne.
Position 38° 18' S, 145° 11' E.
Hastings :©www.mts.org.au
Contact Victoria police of VHF channel 16. Clearance handled by the Melbourne offices.
Boarding station for arrival, as advised by Customs.
Last updated January 2014.
The berthing here is very well protected in this sheltered bay.
There are also moorings and an anchorage north of Hasting Pier.
Last updated January 2014.


| Move Name |
Input |
Damage |
Startup |
Active |
Recovery |
Total |
Block Advantage |
Hit Advantage |
Char 1 Punishable |
Char 2 Punishable |
| {{x.MoveName}} |
{{x.Input}} |
{{x.Damage}} |
{{x.Startup}} |
{{x.Active}} |
{{x.Recovery}} |
{{x.Total}} |
{{x.BlockAdvantage}} |
{{x.HitAdvantage}} |
{{x.Punisher1}} |
{{x.Punisher2}} |


|
|
Hello World! |
// my first program in C++
#include <iostream>
#
) are directives read and interpreted by what is known as the preprocessor. They are special lines interpreted before the compilation of the program itself begins. In this case, the directive #include <iostream>
, instructs the preprocessor to include a section of standard C++ code, known as header iostream, that allows to perform standard input and output operations, such as writing the output of this program (Hello World) to the screen.int main ()
int
), a name (main
) and a pair of parentheses (()
), optionally including parameters.main
is a special function in all C++ programs; it is the function called when the program is run. The execution of all C++ programs begins with the main
function, regardless of where the function is actually located within the code.{
and }
{
) at line 5 indicates the beginning of main
's function definition, and the closing brace (}
) at line 7, indicates its end. Everything between these braces is the function's body that defines what happens when main
is called. All functions use braces to indicate the beginning and end of their definitions.std::cout << "Hello World!";
std::cout
, which identifies the standard character output device (usually, this is the computer screen). Second, the insertion operator (<<
), which indicates that what follows is inserted into std::cout
. Finally, a sentence within quotes ("Hello world!"), is the content inserted into the standard output.;
). This character marks the end of the statement, just as the period ends a sentence in English. All C++ statements must end with a semicolon character. One of the most common syntax errors in C++ is forgetting to end a statement with a semicolon.//
). There is a line with a directive for the preprocessor (beginning with #
). There is a line that defines a function (in this case, the main
function). And, finally, a line with a statements ending with a semicolon (the insertion into cout
), which was within the block delimited by the braces ( { }
) of the main
function.
|
|
|
|
;
), with the separation into different lines not mattering at all for this purpose. Many statements can be written in a single line, or each statement can be in its own line. The division of code in different lines serves only to make it more legible and schematic for the humans that may read it, but has no effect on the actual behavior of the program.
|
|
Hello World! I'm a C++ program |
std::cout
in two different statements. Once again, the separation in different lines of code simply gives greater readability to the program, since main
could have been perfectly valid defined in this way:
|
|
|
|
#
) are out of this general rule since they are not statements. They are lines read and processed by the preprocessor before proper compilation begins. Preprocessor directives must be specified in their own line and, because they are not statements, do not have to end with a semicolon (;
).cout
being used instead of std::cout
. Both name the same object: the first one uses its unqualified name (cout
), while the second qualifies it directly within the namespace std
(as std::cout
).cout
is part of the standard library, and all the elements in the standard C++ library are declared within what is a called a namespace: the namespace std
.std
namespace a program shall either qualify each and every use of elements of the library (as we have done by prefixing cout
with std::
), or introduce visibility of its components. The most typical way to introduce visibility of these components is by means of using declarations:
|
|
std
namespace to be accessed in an unqualified manner (without the std::
prefix).cout
as:
|
|
Hello World! I'm a C++ program |
std
namespace (explicit qualification and using declarations) are valid in C++ and produce the exact same behavior. For simplicity, and to improve readability, the examples in these tutorials will more often use this latter approach with using declarations, although note that explicit qualification is the only way to guarantee that name collisions never happen.| Previous: Compilers | Index | Next: Variables and types |
Comments
As noted above, comments do not affect the operation of the program; however, they provide an important tool to document directly within the source code what the program does and how it operates.C++ supports two ways of commenting code:
The first of them, known as line comment, discards everything from where the pair of slash signs (
//
) are found up to the end of that same line. The second one, known as block comment, discards everything between the/*
characters and the first appearance of the*/
characters, with the possibility of including multiple lines.Let's add comments to our second program:
If comments are included within the source code of a program without using the comment characters combinations
//
,/*
or*/
, the compiler takes them as if they were C++ expressions, most likely causing the compilation to fail with one, or several, error messages.


Brian Templeton, 53, who was staying with his mother in the 100 block of Cornwall Court in Edgewater Park, is charged with first-degree murder and second-degree desecration of human remains.
The investigation began after an employee at the complex asked to check on 77-year-old Doris Templeton, according to authorities.
 He then moved his car to the parking lot of a Willingboro pizza shop, where he was employed as a driver, and began using his mother's car for transportation, authorities said.
Doris Templeton's body was found on Tuesday. A medical examiner determined her cause of death to be bunt force trauma to the head.
Brian Templeton is currently at a medical facility where he is being treated for an ongoing condition, authorities said. Upon his release, he will be scheduled for a detention hearing in Superior Court and the case will be prepared for presentation to a grand jury for a possible indictment.
(The Associated Press contributed to this report.)


--- layout: post title: no title date: '2015-12-29T18:30:52+01:00' categories: - Storyboards - Sketchbooks - Sketches - Horses picture_url: https://film-Storyboards.tumblr.com/post/136219136193 ---


To do this, draw 2 canvas, the second is the "ghost" of the first.
Each shape in the ghost has a unique color which enables to detect which shape has been clicked.
Because I don't know - for the moment - how to synchronize the draggable mode between the vibible canvas and his ghost, I deactivated the draggable mode.
It's experimental but it works fine on Chrome and Firefox
Click on cubes and cylinders + Arrow keys to zoom (or Escape to reset)


PSALMS 63
A psalm written by David when he was in the wilderness in Judah.
1 God, you are the God whom I worship.


Blogger
I found my interest in Food Bloggin. I hangout with my friends as a normal customer and try some new things without getting knowing the owner that I am a blogger. We try some new dishes, capture some good shots and post them afterwards. I started this all with Instagram in January 2021 and now I am moving forward to YouTube. Basically, my work is to do a review of famous restaurants and cafes around the locality.

Ch. Chhabil Dass Public School,Ghaziabad, Uttar Pradesh
Ch. Chhabil Dass Public School,Ghaziabad, Uttar Pradesh
ABES Institute of Technology, Ghaziabad, Uttar Pradesh


Trading_TransactionType Class Reference
| Inherits from | NSObject |
| Conforms to | PicoBindable |
| Declared in | Trading_TransactionType.h Trading_TransactionType.m |
Overview
This type defines the Transaction container, which consists of detailed information
about a single line item in an order. The eBay system creates an order line item
when a buyer has committed to make a purchase in an auction or fixed-price listing.
A multiple-quantity, fixed-priced listing can spawn one or more order line items.
Auction listings and single-quantity, fixed-price listings can only spawn one order
line item.
@ingroup EBayAPIInterface
Tasks
-
amountPaid
This value indicates the total amount of the line item. This amount includes
property
the sale price, shipping and handling charges, shipping
insurance (if offered and selected by the buyer), additional services, and any
applied sales tax. This value is returned after the buyer has completed
checkout (the CheckoutStatus.Status output field reads “Complete”). If the
seller allowed the buyer to change the total for an order, the buyer is
able to change the total up until the time when checkout status is
Complete. Determine whether the buyer changed the amount by retrieving the
order line item data and comparing the AmountPaid value to
what the seller expected. If multiple order line items
between the same buyer and seller have been combined into a Combined
Payment order, the AmountPaid value returned in GetSellerTransactions and
GetItemTransactions reflects the amount paid for the Combined Payment order
and not the individual order line item. You can determine the
order line items that belong to the same Combined Payment order by checking
to see if the ContainingOrder.OrderID value is the same. For Motors items,
AmountPaid is the amount paid by the buyer for the deposit.
Not applicable to Half.com. -
adjustmentAmount
This value indicates the dollar amount by which the buyer has adjusted the
property
order total. Adjustments to order costs may include shipping and handling,
shipping insurance, buyer discounts, or added services. A positive amount
indicates the amount is an extra charge being paid to the seller by the buyer.
A negative value indicates this amount is a credit given to the buyer by the
seller.
Not applicable to Half.com. -
convertedAdjustmentAmount
This value indicates the converted value of AdjustmentAmount in the currency of the site that
property
returned the response. Refresh this value every 24 hours to pick up the
current conversion rates.
Not applicable to Half.com. -
buyer
UserType container consisting of eBay user data for the buyer. See
property
UserType for its child elements. Returned by
GetItemsAwaitingFeedback if the seller is making the request.
Applicable to Half.com (for GetOrders only). -
shippingDetails
Container consisting of shipping-related details for an order. Shipping
property
details include shipping rates, package dimensions, handling costs,
excluded shipping locations (if specified), shipping service options,
shipping insurance information, sales tax information (if applicable), and
shipment tracking details (if shipped).
For GetSellerTransactions and GetItemTransactions, the ShippingDetails
container is returned in the Transaction container. For GetOrders and
GetOrderTransactions, the ShippingDetails container is returned at the
Order level.
Applicable to Half.com (for GetOrders only). -
convertedAmountPaid
This value indicates the converted value of AmountPaid in the currency of the site that returned the
property
response. Refresh this value every 24 hours to pick up the current
conversion rates.
Not applicable to Half.com. -
convertedTransactionPrice
This value indicates the converted value of TransactionPrice in the currency of the site that
property
returned the response. Refresh this value every 24 hours to pick up the
current conversion rates.
Not applicable to Half.com. -
createdDate
Indicates the creation time of the order line item. For
property
auction listings, an order line item is created when that
listing ends with a high bidder whose bid meets or exceeds the Reserve
Price (if set). For a fixed-price listing or a Buy It Now auction listing,
an order line item is created once the buyer clicks the Buy
button.
Applicable to Half.com (for GetOrders only). -
depositType
This value indicates whether or not the seller requires a deposit for the
property
vehicle. This field is only applicable to US eBay Motors Vehicle listings.
Otherwise, this field is returned as an empty value.
Not applicable to Half.com. -
item
Container consisting of details about an item in a listing. The child
property
fields returned are dependent on the call, the type of item or listing, and
the listing site.
Applicable to Half.com (for GetOrders). -
quantityPurchased
This value indicates the number of identical items purchased at the same
property
time by the same buyer from one listing. For auction listings, this value
is always 1. For fixed-price, nonvariation listings, this value can be
greater than 1. In either case, this field is tied to the same order line
item.
Applicable to Half.com (for GetOrders). -
status
Container consisting of status details of an order line item,
property
including payment information. Several of these fields change values during
the checkout flow. See TransactionStatusType for its child elements.
For GetOrders, only the
IntegratedMerchantCreditCardEnabled and
PaymentMethodUsed child elements are returned.
The PaymentHoldStatus container will be returned for those sellers subject to the new eBay payment process. The fields indicating the status of the order are
actually found in the OrderArray.Order.CheckoutStatus
container.
Not applicable to Half.com. -
transactionID
Unique identifier for an eBay order line item. An order line
property
item is created once there is a commitment from a buyer to
purchase an item. Since an auction listing can only have one order line
item during the duration of the listing, the TransactionID
for auction listings is always 0. Along with its corresponding ItemID, a
TransactionID is used and referenced during an order checkout flow and
after checkout has been completed.
Applicable to Half.com (for GetOrders only). -
transactionPrice
The price of one order line item.
property
This price is returned only for Best Offer items. This amount does not take into account shipping, sales tax, and other costs related to the order line item. If multiple units were purchased through Best Offer, this value is the per-unit price.
For eBay Motors Vehicle listings, TransactionPrice is the deposit amount.
Applicable to Half.com (for GetOrders). -
bestOfferSale
Indicates whether or not the order line item was created
property
as the result of the seller accepting a Best Offer from a buyer.
Not applicable to Half.com. -
vatPercent
VAT rate for the item. When the VATPercent is specified, the item’s VAT
property
information appears on the item’s listing page. In addition, the seller
can choose to print an invoice that includes the item’s net price, VAT
percent, VAT amount, and total price. Since VAT rates vary depending on the
item and on the user’s country of residence, a seller is responsible for
entering the correct VAT rate; it is not calculated by eBay. To specify a
VATPercent, a seller must have a VAT-ID registered with eBay and must be
listing the item on a VAT-enabled site. Max precision 3 decimal places. Max
length 5 characters. Note: The View Item page displays the precision to 2
decimal places with no trailing zeros. However, the full value you send in is
stored.
Not applicable to Half.com. -
externalTransaction
Container consisting of details for the electronic payment of an eBay order line item.
property
PayPal transactions may include a buyer payment or refund, or a fee or credit applied
to the seller’s account. This field is only returned after payment for the order line
item has occurred. For DE and AT orders going through the new eBay payment process,
the PaymentHoldDetails container and PaymentHoldStatus
field will be returned instead of the ExternalTransaction container.
Not applicable to Half.com. -
sellingManagerProductDetails
This container consists of Selling Manager product details and is only
property
returned if the item was listed through Selling Manager.
Not applicable to Half.com. -
shippingServiceSelected
Container consisting of details about the domestic or international shipping
property
service selected by the buyer.
Note: For GetItemTransactions and GetSellerTransactions, this container does not return accurate shipping service and cost information for multiple line item orders. Use GetOrders instead, and provide the order’s combined OrderID to retrieve this information.
Not applicable to Half.com. -
buyerMessage
Display message from buyer. This field holds transient data that is only
property
being returned in Checkout related notifications.
Not applicable to Half.com. -
dutchAuctionBid
Dutch auctions are deprecated.
property -
buyerPaidStatus
This value indicates the payment status of an order. This field is only returned for items that have actually
property
been purchased (fixed-price or Buy It Now) or won (auction listings) and not auction listings that have just
been bid on.
Not applicable to Half.com. -
sellerPaidStatus
Specifies the paid status of the order.
property
Not applicable to Half.com. -
paidTime
Indicates the time when the order was marked paid. This value will only be
visible to the user on either side of the order. An order can be marked as
paid in the following ways:- Automatically when a payment is made via PayPal
- Seller marks the [item](#//api/name/item) as paid in My eBay or through Selling Manager Pro
- Programmatically by the seller through the ReviseCheckoutStatus or CompleteSale calls.
property
Not applicable to Half.com. -
shippedTime
Indicates the time when the item(s) associated with the order were marked
property
as shipped. This value will only be visible to the user on either side of
the order. An order can be marked as shipped in My eBay or through Selling
Manager Pro, or programmatically by the seller through the CompleteSale
call.
Applicable to Half.com (for GetOrders only). -
totalPrice
This field indicates the total price for an order line item.
property
For GetMyeBaySelling, with Global Shipping Program orders, the value of this field depends on order status and the number of transactions in the order. For orders awaiting payment, the field contains the purchase price of the order line item; for paid orders, it contains the purchase price of the order line item plus the cost of domestic shipping to the international shipping provider’s warehouse. With single-transaction orders, this field is returned under the OrderTransaction.Transaction container; with multiple-transaction orders, it’s returned under the OrderTransaction.Order.TransactionArray.Transaction container.
Not applicable to Half.com. -
feedbackLeft
This container consists of Feedback left by the caller for their order
property
partner. This container is only returned if the order is complete and
feedback on the order line item has been left by the caller.
Not applicable to Half.com. -
feedbackReceived
This container consists of Feedback received by the caller from their
property
order partner. This container is only returned if the order is complete and
feedback on the order line item has been received by the
caller.
Not applicable to Half.com. -
containingOrder
The Combined Payment order to which the order line item
property
belongs. This container is only returned if IncludeContainingOrder is
included and set to true in a GetItemTransactions or GetSellerTransactions
request.
Not applicable to Half.com. -
finalValueFee
A Final Value Fee is calculated and charged to a seller’s account
property
immediately upon creation of an order line item. Note that this fee is created
before the buyer makes a payment.The Final Value Fee for each order line
item is returned by GetSellerTransactions, GetItemTransactions, GetOrders,
and GetOrderTransactions, regardless of the checkout status.
If a seller requests a Final Value Fee credit, the value of
Transaction.FinalValueFee will not change if a credit is
issued. The credit only appears in the seller’s account data. -
listingCheckoutRedirectPreference
ProStores listing level preferences regarding the store to which
property
checkout should be redirected for the listing if Item.ThirdPartyCheckout
is true. -
refundArray
Container consisting of one or more refund transactions to Half.com buyers.
property
Container consisting of one or more refund transactions for eBay’s new payment process.
This container is only returned if a refund to a Half.com buyer has occurred or an refund was issued through eBay’s new payment process -
transactionSiteID
The site upon which the order line item (transaction) was created.
property -
platform
Name of the eBay co-branded site upon which the order line item
property
(transaction) was created. -
cartID
Unique identifier for an instance of Shopping.com shopping cart. This field is only
property
returned for Shopping.com order line items (transactions). -
sellerContactBuyerByEmail
Indicates whether the buyer has opted to accept emails from all the selling
property
partners on Shopping.com. This field is only returned for order line items
purchased through the Shopping.com shopping cart. -
payPalEmailAddress
The seller’s Paypal email address. This value is only revealed if it is the
property
seller making the call. -
paisaPayID
Unique identifier for a PaisaPay transaction. Only applicable for the India
property
site (203) if PaisaPay was the payment method used. -
buyerGuaranteePrice
For the Australia site, BuyerGuaranteePrice is the PayPal Buyer Protection coverage,
property
offered for the item at the time of purchase. Details of coverage are in the
following sections of the View Item page: the Buy Safely section and the Payment
Details section. -
variation
In a fixed-priced listing, a seller can offer variations of the same item.
property
For example, the seller could create a fixed-priced listing for a t-shirt
design and offer the shirt in different colors and sizes. In this case, each
color and size combination is a separate variation. Each variation can have
a different quantity and price. Due to the possible price differentiation,
buyers can buy multiple items from this listing at the same time, but all of
the items must be of the same variation. One order line item is created
whether one or multiple items of the same variation are purchased.
The Variation node contains information about which variation
was purchased. Therefore, applications that process orders
should always check to see if this node is present. -
buyerCheckoutMessage
This field is returned if a buyer left a comment for the seller during the
property
left by buyer during the checkout flow. -
totalTransactionPrice
The price of one order line item. This amount does not take into account shipping, sales tax, and other costs related to the order line item.
property
If multiple units were purchased through a nonvariation, fixed-price listing, consider this value the per-unit price. To get the total amount, multiply TotalTransactionPrice by the Transaction.QuantityPurchased value.
For eBay Motors Vehicle listings, TotalTransactionPrice is the deposit amount.
Applicable to Half.com (for GetOrders). -
taxes
type : class Trading_TaxesType
property -
bundlePurchase
Boolean value indicating whether or not an order line item is
property
part of a bundle purchase using Product Configurator. -
actualShippingCost
The shipping cost charged to the buyer for the order line item.
property
For GetOrders, this field is returned only after checkout is completed on the order. A value of0.00
indicates free shipping.
For other calls, this field is always returned but defaults to0.00
until payment has been made on the order.
Note: This is different from the field of the same name returned by GetSellingManagerSaleRecord and ReviseSellingManagerSaleRecord, which contains the actual shipping cost paid by the seller.
-
actualHandlingCost
The handling cost for the order line item. The value of this field is
property
returned as zero dollars if the seller did not specify a handling cost for
the listing. It also will show as 0.00 dollars until payment has been made
on the order. -
orderLineItemID
A unique identifier for an eBay order line item. This field is created as
property
soon as there is a commitment to buy from the seller, and its value is
based upon the concatenation of ItemID and TransactionID, with a hyphen in
between these two IDs. -
paymentHoldDetails
Shipping hold details
property -
sellerDiscounts
Seller Discounts
property -
refundAmount
Partial or Full refund amount from seller to the buyer
property -
refundStatus
Refund Status Notification to Seller (Success, Failure, Pending)
property -
codiceFiscale
This field is returned if the IncludeCodeFiscale flag is
property
included in the request and set to ‘true’, and if the buyer has provided this value
at checkout time.
This field is only applicable to Italian sellers. The Codice Fiscale number is
unique for each Italian citizen and is used for tax purposes. -
isMultiLegShipping
If IsMultilegShipping is true, the order or transaction uses the Global Shipping Program, in which the shipment has a domestic leg and an international leg. The buyer’s shipping address is in a country other than the country where the items were listed, and the Get family of calls will return
propertyInternationalPriorityShipping
as the default international shipping service in the listings of all the items in the order.
If IsMultilegShipping is false, the order or transaction does not use the Global Shipping Program. The shipment might use a different international shipping service, or it might be domestic. -
multiLegShippingDetails
Contains details about the domestic leg of a Global Shipping Program shipment.
property
This information is not returned if IsMultilegShipping is false. -
invoiceSentTime
This field indicates the date/time that an order invoice was sent from the seller
property
to the buyer. This field is only returned if an invoice (containing the order
line item) was sent to the buyer. -
unpaidItem
Container consisting of details related to the type and status of an Unpaid
property
Item case. This container is only returned if there is an open or closed
Unpaid Item case associated with the order line item. -
intangibleItem
This flag indicates whether or not the order line item is an
property
intangible good such as an MP3 track or a mobile phone ringtone. Intangible items
are not eligible for PayPal’s Seller Protection program, so the seller will not be
able to open an Unpaid Item case against the buyer. -
any
(public property)
property
Properties
actualHandlingCost
The handling cost for the order line item. The value of this field is
returned as zero dollars if the seller did not specify a handling cost for
the listing. It also will show as 0.00 dollars until payment has been made
on the order.
@property (nonatomic, retain) Trading_AmountType *actualHandlingCost
Discussion
The handling cost for the order line item. The value of this field is
returned as zero dollars if the seller did not specify a handling cost for
the listing. It also will show as 0.00 dollars until payment has been made
on the order.
type : class Trading_AmountType
Declared In
Trading_TransactionType.h
actualShippingCost
The shipping cost charged to the buyer for the order line item.
For GetOrders, this field is returned only after checkout is completed on the order. A value of 0.00
indicates free shipping.
For other calls, this field is always returned but defaults to 0.00
until payment has been made on the order.
Note: This is different from the field of the same name returned by GetSellingManagerSaleRecord and ReviseSellingManagerSaleRecord, which contains the actual shipping cost paid by the seller.
@property (nonatomic, retain) Trading_AmountType *actualShippingCost
Discussion
The shipping cost charged to the buyer for the order line item.
For GetOrders, this field is returned only after checkout is completed on the order. A value of 0.00
indicates free shipping.
For other calls, this field is always returned but defaults to 0.00
until payment has been made on the order.
Note: This is different from the field of the same name returned by GetSellingManagerSaleRecord and ReviseSellingManagerSaleRecord, which contains the actual shipping cost paid by the seller.
type : class Trading_AmountType
Declared In
Trading_TransactionType.h
adjustmentAmount
This value indicates the dollar amount by which the buyer has adjusted the
order total. Adjustments to order costs may include shipping and handling,
shipping insurance, buyer discounts, or added services. A positive amount
indicates the amount is an extra charge being paid to the seller by the buyer.
A negative value indicates this amount is a credit given to the buyer by the
seller.
Not applicable to Half.com.
@property (nonatomic, retain) Trading_AmountType *adjustmentAmount
Discussion
This value indicates the dollar amount by which the buyer has adjusted the
order total. Adjustments to order costs may include shipping and handling,
shipping insurance, buyer discounts, or added services. A positive amount
indicates the amount is an extra charge being paid to the seller by the buyer.
A negative value indicates this amount is a credit given to the buyer by the
seller.
Not applicable to Half.com.
type : class Trading_AmountType
Declared In
Trading_TransactionType.h
amountPaid
This value indicates the total amount of the line item. This amount includes
the sale price, shipping and handling charges, shipping
insurance (if offered and selected by the buyer), additional services, and any
applied sales tax. This value is returned after the buyer has completed
checkout (the CheckoutStatus.Status output field reads “Complete”). If the
seller allowed the buyer to change the total for an order, the buyer is
able to change the total up until the time when checkout status is
Complete. Determine whether the buyer changed the amount by retrieving the
order line item data and comparing the AmountPaid value to
what the seller expected. If multiple order line items
between the same buyer and seller have been combined into a Combined
Payment order, the AmountPaid value returned in GetSellerTransactions and
GetItemTransactions reflects the amount paid for the Combined Payment order
and not the individual order line item. You can determine the
order line items that belong to the same Combined Payment order by checking
to see if the ContainingOrder.OrderID value is the same. For Motors items,
AmountPaid is the amount paid by the buyer for the deposit.
Not applicable to Half.com.
@property (nonatomic, retain) Trading_AmountType *amountPaid
Discussion
This value indicates the total amount of the line item. This amount includes
the sale price, shipping and handling charges, shipping
insurance (if offered and selected by the buyer), additional services, and any
applied sales tax. This value is returned after the buyer has completed
checkout (the CheckoutStatus.Status output field reads “Complete”). If the
seller allowed the buyer to change the total for an order, the buyer is
able to change the total up until the time when checkout status is
Complete. Determine whether the buyer changed the amount by retrieving the
order line item data and comparing the AmountPaid value to
what the seller expected. If multiple order line items
between the same buyer and seller have been combined into a Combined
Payment order, the AmountPaid value returned in GetSellerTransactions and
GetItemTransactions reflects the amount paid for the Combined Payment order
and not the individual order line item. You can determine the
order line items that belong to the same Combined Payment order by checking
to see if the ContainingOrder.OrderID value is the same. For Motors items,
AmountPaid is the amount paid by the buyer for the deposit.
Not applicable to Half.com.
type : class Trading_AmountType
Declared In
Trading_TransactionType.h
any
(public property)
@property (nonatomic, retain) NSMutableArray *any
Discussion
(public property)
entry type : PicoAnyElement, wrapper for primitive anyelement
Declared In
Trading_TransactionType.h
bestOfferSale
Indicates whether or not the order line item was created
as the result of the seller accepting a Best Offer from a buyer.
Not applicable to Half.com.
@property (nonatomic, retain) NSNumber *bestOfferSale
Discussion
Indicates whether or not the order line item was created
as the result of the seller accepting a Best Offer from a buyer.
Not applicable to Half.com.
type : NSNumber, wrapper for primitive bool
Declared In
Trading_TransactionType.h
bundlePurchase
Boolean value indicating whether or not an order line item is
part of a bundle purchase using Product Configurator.
@property (nonatomic, retain) NSNumber *bundlePurchase
Discussion
Boolean value indicating whether or not an order line item is
part of a bundle purchase using Product Configurator.
type : NSNumber, wrapper for primitive bool
Declared In
Trading_TransactionType.h
buyer
UserType container consisting of eBay user data for the buyer. See
UserType for its child elements. Returned by
GetItemsAwaitingFeedback if the seller is making the request.
Applicable to Half.com (for GetOrders only).
@property (nonatomic, retain) Trading_UserType *buyer
Discussion
UserType container consisting of eBay user data for the buyer. See
UserType for its child elements. Returned by
GetItemsAwaitingFeedback if the seller is making the request.
Applicable to Half.com (for GetOrders only).
type : class Trading_UserType
Declared In
Trading_TransactionType.h
buyerCheckoutMessage
This field is returned if a buyer left a comment for the seller during the
left by buyer during the checkout flow.
@property (nonatomic, retain) NSString *buyerCheckoutMessage
Discussion
This field is returned if a buyer left a comment for the seller during the
left by buyer during the checkout flow.
type : NSString, wrapper for primitive string
Declared In
Trading_TransactionType.h
buyerGuaranteePrice
For the Australia site, BuyerGuaranteePrice is the PayPal Buyer Protection coverage,
offered for the item at the time of purchase. Details of coverage are in the
following sections of the View Item page: the Buy Safely section and the Payment
Details section.
@property (nonatomic, retain) Trading_AmountType *buyerGuaranteePrice
Discussion
For the Australia site, BuyerGuaranteePrice is the PayPal Buyer Protection coverage,
offered for the item at the time of purchase. Details of coverage are in the
following sections of the View Item page: the Buy Safely section and the Payment
Details section.
type : class Trading_AmountType
Declared In
Trading_TransactionType.h
buyerMessage
Display message from buyer. This field holds transient data that is only
being returned in Checkout related notifications.
Not applicable to Half.com.
@property (nonatomic, retain) NSString *buyerMessage
Discussion
Display message from buyer. This field holds transient data that is only
being returned in Checkout related notifications.
Not applicable to Half.com.
type : NSString, wrapper for primitive string
Declared In
Trading_TransactionType.h
buyerPaidStatus
This value indicates the payment status of an order. This field is only returned for items that have actually
been purchased (fixed-price or Buy It Now) or won (auction listings) and not auction listings that have just
been bid on.
Not applicable to Half.com.
@property (nonatomic, retain) NSString *buyerPaidStatus
Discussion
This value indicates the payment status of an order. This field is only returned for items that have actually
been purchased (fixed-price or Buy It Now) or won (auction listings) and not auction listings that have just
been bid on.
Not applicable to Half.com.
type: string constant in Trading_PaidStatusCodeType.h
Declared In
Trading_TransactionType.h
cartID
Unique identifier for an instance of Shopping.com shopping cart. This field is only
returned for Shopping.com order line items (transactions).
@property (nonatomic, retain) NSString *cartID
Discussion
Unique identifier for an instance of Shopping.com shopping cart. This field is only
returned for Shopping.com order line items (transactions).
type : NSString, wrapper for primitive string
Declared In
Trading_TransactionType.h
codiceFiscale
This field is returned if the IncludeCodeFiscale flag is
included in the request and set to ‘true’, and if the buyer has provided this value
at checkout time.
This field is only applicable to Italian sellers. The Codice Fiscale number is
unique for each Italian citizen and is used for tax purposes.
@property (nonatomic, retain) NSString *codiceFiscale
Discussion
This field is returned if the IncludeCodeFiscale flag is
included in the request and set to ‘true’, and if the buyer has provided this value
at checkout time.
This field is only applicable to Italian sellers. The Codice Fiscale number is
unique for each Italian citizen and is used for tax purposes.
type : NSString, wrapper for primitive string
Declared In
Trading_TransactionType.h
containingOrder
The Combined Payment order to which the order line item
belongs. This container is only returned if IncludeContainingOrder is
included and set to true in a GetItemTransactions or GetSellerTransactions
request.
Not applicable to Half.com.
@property (nonatomic, retain) Trading_OrderType *containingOrder
Discussion
The Combined Payment order to which the order line item
belongs. This container is only returned if IncludeContainingOrder is
included and set to true in a GetItemTransactions or GetSellerTransactions
request.
Not applicable to Half.com.
type : class Trading_OrderType
Declared In
Trading_TransactionType.h
convertedAdjustmentAmount
This value indicates the converted value of AdjustmentAmount in the currency of the site that
returned the response. Refresh this value every 24 hours to pick up the
current conversion rates.
Not applicable to Half.com.
@property (nonatomic, retain) Trading_AmountType *convertedAdjustmentAmount
Discussion
This value indicates the converted value of AdjustmentAmount in the currency of the site that
returned the response. Refresh this value every 24 hours to pick up the
current conversion rates.
Not applicable to Half.com.
type : class Trading_AmountType
Declared In
Trading_TransactionType.h
convertedAmountPaid
This value indicates the converted value of AmountPaid in the currency of the site that returned the
response. Refresh this value every 24 hours to pick up the current
conversion rates.
Not applicable to Half.com.
@property (nonatomic, retain) Trading_AmountType *convertedAmountPaid
Discussion
This value indicates the converted value of AmountPaid in the currency of the site that returned the
response. Refresh this value every 24 hours to pick up the current
conversion rates.
Not applicable to Half.com.
type : class Trading_AmountType
Declared In
Trading_TransactionType.h
convertedTransactionPrice
This value indicates the converted value of TransactionPrice in the currency of the site that
returned the response. Refresh this value every 24 hours to pick up the
current conversion rates.
Not applicable to Half.com.
@property (nonatomic, retain) Trading_AmountType *convertedTransactionPrice
Discussion
This value indicates the converted value of TransactionPrice in the currency of the site that
returned the response. Refresh this value every 24 hours to pick up the
current conversion rates.
Not applicable to Half.com.
type : class Trading_AmountType
Declared In
Trading_TransactionType.h
createdDate
Indicates the creation time of the order line item. For
auction listings, an order line item is created when that
listing ends with a high bidder whose bid meets or exceeds the Reserve
Price (if set). For a fixed-price listing or a Buy It Now auction listing,
an order line item is created once the buyer clicks the Buy
button.
Applicable to Half.com (for GetOrders only).
@property (nonatomic, retain) NSDate *createdDate
Discussion
Indicates the creation time of the order line item. For
auction listings, an order line item is created when that
listing ends with a high bidder whose bid meets or exceeds the Reserve
Price (if set). For a fixed-price listing or a Buy It Now auction listing,
an order line item is created once the buyer clicks the Buy
button.
Applicable to Half.com (for GetOrders only).
type : NSDate, wrapper for primitive date
Declared In
Trading_TransactionType.h
depositType
This value indicates whether or not the seller requires a deposit for the
vehicle. This field is only applicable to US eBay Motors Vehicle listings.
Otherwise, this field is returned as an empty value.
Not applicable to Half.com.
@property (nonatomic, retain) NSString *depositType
Discussion
This value indicates whether or not the seller requires a deposit for the
vehicle. This field is only applicable to US eBay Motors Vehicle listings.
Otherwise, this field is returned as an empty value.
Not applicable to Half.com.
type: string constant in Trading_DepositTypeCodeType.h
Declared In
Trading_TransactionType.h
dutchAuctionBid
Dutch auctions are deprecated.
@property (nonatomic, retain) Trading_AmountType *dutchAuctionBid
Declared In
Trading_TransactionType.h
externalTransaction
Container consisting of details for the electronic payment of an eBay order line item.
PayPal transactions may include a buyer payment or refund, or a fee or credit applied
to the seller’s account. This field is only returned after payment for the order line
item has occurred. For DE and AT orders going through the new eBay payment process,
the PaymentHoldDetails container and PaymentHoldStatus
field will be returned instead of the ExternalTransaction container.
Not applicable to Half.com.
@property (nonatomic, retain) NSMutableArray *externalTransaction
Discussion
Container consisting of details for the electronic payment of an eBay order line item.
PayPal transactions may include a buyer payment or refund, or a fee or credit applied
to the seller’s account. This field is only returned after payment for the order line
item has occurred. For DE and AT orders going through the new eBay payment process,
the PaymentHoldDetails container and PaymentHoldStatus
field will be returned instead of the ExternalTransaction container.
Not applicable to Half.com.
entry type : class Trading_ExternalTransactionType
Declared In
Trading_TransactionType.h
feedbackLeft
This container consists of Feedback left by the caller for their order
partner. This container is only returned if the order is complete and
feedback on the order line item has been left by the caller.
Not applicable to Half.com.
@property (nonatomic, retain) Trading_FeedbackInfoType *feedbackLeft
Discussion
This container consists of Feedback left by the caller for their order
partner. This container is only returned if the order is complete and
feedback on the order line item has been left by the caller.
Not applicable to Half.com.
type : class Trading_FeedbackInfoType
Declared In
Trading_TransactionType.h
feedbackReceived
This container consists of Feedback received by the caller from their
order partner. This container is only returned if the order is complete and
feedback on the order line item has been received by the
caller.
Not applicable to Half.com.
@property (nonatomic, retain) Trading_FeedbackInfoType *feedbackReceived
Discussion
This container consists of Feedback received by the caller from their
order partner. This container is only returned if the order is complete and
feedback on the order line item has been received by the
caller.
Not applicable to Half.com.
type : class Trading_FeedbackInfoType
Declared In
Trading_TransactionType.h
finalValueFee
A Final Value Fee is calculated and charged to a seller’s account
immediately upon creation of an order line item. Note that this fee is created
before the buyer makes a payment.The Final Value Fee for each order line
item is returned by GetSellerTransactions, GetItemTransactions, GetOrders,
and GetOrderTransactions, regardless of the checkout status.
If a seller requests a Final Value Fee credit, the value of
Transaction.FinalValueFee will not change if a credit is
issued. The credit only appears in the seller’s account data.
@property (nonatomic, retain) Trading_AmountType *finalValueFee
Discussion
A Final Value Fee is calculated and charged to a seller’s account
immediately upon creation of an order line item. Note that this fee is created
before the buyer makes a payment.The Final Value Fee for each order line
item is returned by GetSellerTransactions, GetItemTransactions, GetOrders,
and GetOrderTransactions, regardless of the checkout status.
If a seller requests a Final Value Fee credit, the value of
Transaction.FinalValueFee will not change if a credit is
issued. The credit only appears in the seller’s account data.
Not applicable to Half.com.
type : class Trading_AmountType
Declared In
Trading_TransactionType.h
intangibleItem
This flag indicates whether or not the order line item is an
intangible good such as an MP3 track or a mobile phone ringtone. Intangible items
are not eligible for PayPal’s Seller Protection program, so the seller will not be
able to open an Unpaid Item case against the buyer.
@property (nonatomic, retain) NSNumber *intangibleItem
Discussion
This flag indicates whether or not the order line item is an
intangible good such as an MP3 track or a mobile phone ringtone. Intangible items
are not eligible for PayPal’s Seller Protection program, so the seller will not be
able to open an Unpaid Item case against the buyer.
type : NSNumber, wrapper for primitive bool
Declared In
Trading_TransactionType.h
invoiceSentTime
This field indicates the date/time that an order invoice was sent from the seller
to the buyer. This field is only returned if an invoice (containing the order
line item) was sent to the buyer.
@property (nonatomic, retain) NSDate *invoiceSentTime
Discussion
This field indicates the date/time that an order invoice was sent from the seller
to the buyer. This field is only returned if an invoice (containing the order
line item) was sent to the buyer.
type : NSDate, wrapper for primitive date
Declared In
Trading_TransactionType.h
isMultiLegShipping
If IsMultilegShipping is true, the order or transaction uses the Global Shipping Program, in which the shipment has a domestic leg and an international leg. The buyer’s shipping address is in a country other than the country where the items were listed, and the Get family of calls will return InternationalPriorityShipping
as the default international shipping service in the listings of all the items in the order.
If IsMultilegShipping is false, the order or transaction does not use the Global Shipping Program. The shipment might use a different international shipping service, or it might be domestic.
@property (nonatomic, retain) NSNumber *isMultiLegShipping
Discussion
If IsMultilegShipping is true, the order or transaction uses the Global Shipping Program, in which the shipment has a domestic leg and an international leg. The buyer’s shipping address is in a country other than the country where the items were listed, and the Get family of calls will return InternationalPriorityShipping
as the default international shipping service in the listings of all the items in the order.
If IsMultilegShipping is false, the order or transaction does not use the Global Shipping Program. The shipment might use a different international shipping service, or it might be domestic.
type : NSNumber, wrapper for primitive bool
Declared In
Trading_TransactionType.h
item
Container consisting of details about an item in a listing. The child
fields returned are dependent on the call, the type of item or listing, and
the listing site.
Applicable to Half.com (for GetOrders).
@property (nonatomic, retain) Trading_ItemType *item
Discussion
Container consisting of details about an item in a listing. The child
fields returned are dependent on the call, the type of item or listing, and
the listing site.
Applicable to Half.com (for GetOrders).
type : class Trading_ItemType
Declared In
Trading_TransactionType.h
listingCheckoutRedirectPreference
ProStores listing level preferences regarding the store to which
checkout should be redirected for the listing if Item.ThirdPartyCheckout
is true.
@property (nonatomic, retain) Trading_ListingCheckoutRedirectPreferenceType *listingCheckoutRedirectPreference
Discussion
ProStores listing level preferences regarding the store to which
checkout should be redirected for the listing if Item.ThirdPartyCheckout
is true.
type : class Trading_ListingCheckoutRedirectPreferenceType
Declared In
Trading_TransactionType.h
multiLegShippingDetails
Contains details about the domestic leg of a Global Shipping Program shipment.
This information is not returned if IsMultilegShipping is false.
@property (nonatomic, retain) Trading_MultiLegShippingDetailsType *multiLegShippingDetails
Discussion
Contains details about the domestic leg of a Global Shipping Program shipment.
This information is not returned if IsMultilegShipping is false.
type : class Trading_MultiLegShippingDetailsType
Declared In
Trading_TransactionType.h
orderLineItemID
A unique identifier for an eBay order line item. This field is created as
soon as there is a commitment to buy from the seller, and its value is
based upon the concatenation of ItemID and TransactionID, with a hyphen in
between these two IDs.
@property (nonatomic, retain) NSString *orderLineItemID
Discussion
A unique identifier for an eBay order line item. This field is created as
soon as there is a commitment to buy from the seller, and its value is
based upon the concatenation of ItemID and TransactionID, with a hyphen in
between these two IDs.
type : NSString, wrapper for primitive string
Declared In
Trading_TransactionType.h
paidTime
Indicates the time when the order was marked paid. This value will only be
visible to the user on either side of the order. An order can be marked as
paid in the following ways:
- Automatically when a payment is made via PayPal
- Seller marks the [item](#//api/name/item) as paid in My eBay or through Selling Manager Pro
- Programmatically by the seller through the ReviseCheckoutStatus or CompleteSale calls.
Not applicable to Half.com.
@property (nonatomic, retain) NSDate *paidTime
Discussion
Indicates the time when the order was marked paid. This value will only be
visible to the user on either side of the order. An order can be marked as
paid in the following ways:
- Automatically when a payment is made via PayPal
- Seller marks the [item](#//api/name/item) as paid in My eBay or through Selling Manager Pro
- Programmatically by the seller through the ReviseCheckoutStatus or CompleteSale calls.
Not applicable to Half.com.
type : NSDate, wrapper for primitive date
Declared In
Trading_TransactionType.h
paisaPayID
Unique identifier for a PaisaPay transaction. Only applicable for the India
site (203) if PaisaPay was the payment method used.
@property (nonatomic, retain) NSString *paisaPayID
Discussion
Unique identifier for a PaisaPay transaction. Only applicable for the India
site (203) if PaisaPay was the payment method used.
type : NSString, wrapper for primitive string
Declared In
Trading_TransactionType.h
payPalEmailAddress
The seller’s Paypal email address. This value is only revealed if it is the
seller making the call.
@property (nonatomic, retain) NSString *payPalEmailAddress
Discussion
The seller’s Paypal email address. This value is only revealed if it is the
seller making the call.
type : NSString, wrapper for primitive string
Declared In
Trading_TransactionType.h
paymentHoldDetails
Shipping hold details
@property (nonatomic, retain) Trading_PaymentHoldDetailType *paymentHoldDetails
Declared In
Trading_TransactionType.h
platform
Name of the eBay co-branded site upon which the order line item
(transaction) was created.
@property (nonatomic, retain) NSString *platform
Discussion
Name of the eBay co-branded site upon which the order line item
(transaction) was created.
type: string constant in Trading_TransactionPlatformCodeType.h
Declared In
Trading_TransactionType.h
quantityPurchased
This value indicates the number of identical items purchased at the same
time by the same buyer from one listing. For auction listings, this value
is always 1. For fixed-price, nonvariation listings, this value can be
greater than 1. In either case, this field is tied to the same order line
item.
Applicable to Half.com (for GetOrders).
@property (nonatomic, retain) NSNumber *quantityPurchased
Discussion
This value indicates the number of identical items purchased at the same
time by the same buyer from one listing. For auction listings, this value
is always 1. For fixed-price, nonvariation listings, this value can be
greater than 1. In either case, this field is tied to the same order line
item.
Applicable to Half.com (for GetOrders).
type : NSNumber, wrapper for primitive int
Declared In
Trading_TransactionType.h
refundAmount
Partial or Full refund amount from seller to the buyer
@property (nonatomic, retain) Trading_AmountType *refundAmount
Declared In
Trading_TransactionType.h
refundArray
Container consisting of one or more refund transactions to Half.com buyers.
Container consisting of one or more refund transactions for eBay’s new payment process.
This container is only returned if a refund to a Half.com buyer has occurred or an refund was issued through eBay’s new payment process
@property (nonatomic, retain) Trading_RefundArrayType *refundArray
Discussion
Container consisting of one or more refund transactions to Half.com buyers.
Container consisting of one or more refund transactions for eBay’s new payment process.
This container is only returned if a refund to a Half.com buyer has occurred or an refund was issued through eBay’s new payment process
type : class Trading_RefundArrayType
Declared In
Trading_TransactionType.h
refundStatus
Refund Status Notification to Seller (Success, Failure, Pending)
@property (nonatomic, retain) NSString *refundStatus
Discussion
Refund Status Notification to Seller (Success, Failure, Pending)
type : NSString, wrapper for primitive string
Declared In
Trading_TransactionType.h
sellerContactBuyerByEmail
Indicates whether the buyer has opted to accept emails from all the selling
partners on Shopping.com. This field is only returned for order line items
purchased through the Shopping.com shopping cart.
@property (nonatomic, retain) NSNumber *sellerContactBuyerByEmail
Discussion
Indicates whether the buyer has opted to accept emails from all the selling
partners on Shopping.com. This field is only returned for order line items
purchased through the Shopping.com shopping cart.
type : NSNumber, wrapper for primitive bool
Declared In
Trading_TransactionType.h
sellerDiscounts
Seller Discounts
@property (nonatomic, retain) Trading_SellerDiscountsType *sellerDiscounts
Declared In
Trading_TransactionType.h
sellerPaidStatus
Specifies the paid status of the order.
Not applicable to Half.com.
@property (nonatomic, retain) NSString *sellerPaidStatus
Discussion
Specifies the paid status of the order.
Not applicable to Half.com.
type: string constant in Trading_PaidStatusCodeType.h
Declared In
Trading_TransactionType.h
sellingManagerProductDetails
This container consists of Selling Manager product details and is only
returned if the item was listed through Selling Manager.
Not applicable to Half.com.
@property (nonatomic, retain) Trading_SellingManagerProductDetailsType *sellingManagerProductDetails
Discussion
This container consists of Selling Manager product details and is only
returned if the item was listed through Selling Manager.
Not applicable to Half.com.
type : class Trading_SellingManagerProductDetailsType
Declared In
Trading_TransactionType.h
shippedTime
Indicates the time when the item(s) associated with the order were marked
as shipped. This value will only be visible to the user on either side of
the order. An order can be marked as shipped in My eBay or through Selling
Manager Pro, or programmatically by the seller through the CompleteSale
call.
Applicable to Half.com (for GetOrders only).
@property (nonatomic, retain) NSDate *shippedTime
Discussion
Indicates the time when the item(s) associated with the order were marked
as shipped. This value will only be visible to the user on either side of
the order. An order can be marked as shipped in My eBay or through Selling
Manager Pro, or programmatically by the seller through the CompleteSale
call.
Applicable to Half.com (for GetOrders only).
type : NSDate, wrapper for primitive date
Declared In
Trading_TransactionType.h
shippingDetails
Container consisting of shipping-related details for an order. Shipping
details include shipping rates, package dimensions, handling costs,
excluded shipping locations (if specified), shipping service options,
shipping insurance information, sales tax information (if applicable), and
shipment tracking details (if shipped).
For GetSellerTransactions and GetItemTransactions, the ShippingDetails
container is returned in the Transaction container. For GetOrders and
GetOrderTransactions, the ShippingDetails container is returned at the
Order level.
Applicable to Half.com (for GetOrders only).
@property (nonatomic, retain) Trading_ShippingDetailsType *shippingDetails
Discussion
Container consisting of shipping-related details for an order. Shipping
details include shipping rates, package dimensions, handling costs,
excluded shipping locations (if specified), shipping service options,
shipping insurance information, sales tax information (if applicable), and
shipment tracking details (if shipped).
For GetSellerTransactions and GetItemTransactions, the ShippingDetails
container is returned in the Transaction container. For GetOrders and
GetOrderTransactions, the ShippingDetails container is returned at the
Order level.
Applicable to Half.com (for GetOrders only).
type : class Trading_ShippingDetailsType
Declared In
Trading_TransactionType.h
shippingServiceSelected
Container consisting of details about the domestic or international shipping
service selected by the buyer.
Note: For GetItemTransactions and GetSellerTransactions, this container does not return accurate shipping service and cost information for multiple line item orders. Use GetOrders instead, and provide the order’s combined OrderID to retrieve this information.
Not applicable to Half.com.
@property (nonatomic, retain) Trading_ShippingServiceOptionsType *shippingServiceSelected
Discussion
Container consisting of details about the domestic or international shipping
service selected by the buyer.
Note: For GetItemTransactions and GetSellerTransactions, this container does not return accurate shipping service and cost information for multiple line item orders. Use GetOrders instead, and provide the order’s combined OrderID to retrieve this information.
Not applicable to Half.com.
type : class Trading_ShippingServiceOptionsType
Declared In
Trading_TransactionType.h
status
Container consisting of status details of an order line item,
including payment information. Several of these fields change values during
the checkout flow. See TransactionStatusType for its child elements.
For GetOrders, only the
IntegratedMerchantCreditCardEnabled and
PaymentMethodUsed child elements are returned.
The PaymentHoldStatus container will be returned for those sellers subject to the new eBay payment process. The fields indicating the status of the order are
actually found in the OrderArray.Order.CheckoutStatus
container.
Not applicable to Half.com.
@property (nonatomic, retain) Trading_TransactionStatusType *status
Discussion
Container consisting of status details of an order line item,
including payment information. Several of these fields change values during
the checkout flow. See TransactionStatusType for its child elements.
For GetOrders, only the
IntegratedMerchantCreditCardEnabled and
PaymentMethodUsed child elements are returned.
The PaymentHoldStatus container will be returned for those sellers subject to the new eBay payment process. The fields indicating the status of the order are
actually found in the OrderArray.Order.CheckoutStatus
container.
Not applicable to Half.com.
type : class Trading_TransactionStatusType
Declared In
Trading_TransactionType.h
taxes
type : class Trading_TaxesType
@property (nonatomic, retain) Trading_TaxesType *taxes
Discussion
type : class Trading_TaxesType
Declared In
Trading_TransactionType.h
totalPrice
This field indicates the total price for an order line item.
For GetMyeBaySelling, with Global Shipping Program orders, the value of this field depends on order status and the number of transactions in the order. For orders awaiting payment, the field contains the purchase price of the order line item; for paid orders, it contains the purchase price of the order line item plus the cost of domestic shipping to the international shipping provider’s warehouse. With single-transaction orders, this field is returned under the OrderTransaction.Transaction container; with multiple-transaction orders, it’s returned under the OrderTransaction.Order.TransactionArray.Transaction container.
Not applicable to Half.com.
@property (nonatomic, retain) Trading_AmountType *totalPrice
Discussion
This field indicates the total price for an order line item.
For GetMyeBaySelling, with Global Shipping Program orders, the value of this field depends on order status and the number of transactions in the order. For orders awaiting payment, the field contains the purchase price of the order line item; for paid orders, it contains the purchase price of the order line item plus the cost of domestic shipping to the international shipping provider’s warehouse. With single-transaction orders, this field is returned under the OrderTransaction.Transaction container; with multiple-transaction orders, it’s returned under the OrderTransaction.Order.TransactionArray.Transaction container.
Not applicable to Half.com.
type : class Trading_AmountType
Declared In
Trading_TransactionType.h
totalTransactionPrice
The price of one order line item. This amount does not take into account shipping, sales tax, and other costs related to the order line item.
If multiple units were purchased through a nonvariation, fixed-price listing, consider this value the per-unit price. To get the total amount, multiply TotalTransactionPrice by the Transaction.QuantityPurchased value.
For eBay Motors Vehicle listings, TotalTransactionPrice is the deposit amount.
Applicable to Half.com (for GetOrders).
@property (nonatomic, retain) Trading_AmountType *totalTransactionPrice
Discussion
The price of one order line item. This amount does not take into account shipping, sales tax, and other costs related to the order line item.
If multiple units were purchased through a nonvariation, fixed-price listing, consider this value the per-unit price. To get the total amount, multiply TotalTransactionPrice by the Transaction.QuantityPurchased value.
For eBay Motors Vehicle listings, TotalTransactionPrice is the deposit amount.
Applicable to Half.com (for GetOrders).
type : class Trading_AmountType
Declared In
Trading_TransactionType.h
transactionID
Unique identifier for an eBay order line item. An order line
item is created once there is a commitment from a buyer to
purchase an item. Since an auction listing can only have one order line
item during the duration of the listing, the TransactionID
for auction listings is always 0. Along with its corresponding ItemID, a
TransactionID is used and referenced during an order checkout flow and
after checkout has been completed.
Applicable to Half.com (for GetOrders only).
@property (nonatomic, retain) NSString *transactionID
Discussion
Unique identifier for an eBay order line item. An order line
item is created once there is a commitment from a buyer to
purchase an item. Since an auction listing can only have one order line
item during the duration of the listing, the TransactionID
for auction listings is always 0. Along with its corresponding ItemID, a
TransactionID is used and referenced during an order checkout flow and
after checkout has been completed.
Applicable to Half.com (for GetOrders only).
type : NSString, wrapper for primitive string
Declared In
Trading_TransactionType.h
transactionPrice
The price of one order line item.
This price is returned only for Best Offer items. This amount does not take into account shipping, sales tax, and other costs related to the order line item. If multiple units were purchased through Best Offer, this value is the per-unit price.
For eBay Motors Vehicle listings, TransactionPrice is the deposit amount.
Applicable to Half.com (for GetOrders).
@property (nonatomic, retain) Trading_AmountType *transactionPrice
Discussion
The price of one order line item.
This price is returned only for Best Offer items. This amount does not take into account shipping, sales tax, and other costs related to the order line item. If multiple units were purchased through Best Offer, this value is the per-unit price.
For eBay Motors Vehicle listings, TransactionPrice is the deposit amount.
Applicable to Half.com (for GetOrders).
type : class Trading_AmountType
Declared In
Trading_TransactionType.h
transactionSiteID
The site upon which the order line item (transaction) was created.
@property (nonatomic, retain) NSString *transactionSiteID
Discussion
The site upon which the order line item (transaction) was created.
type: string constant in Trading_SiteCodeType.h
Declared In
Trading_TransactionType.h
unpaidItem
Container consisting of details related to the type and status of an Unpaid
Item case. This container is only returned if there is an open or closed
Unpaid Item case associated with the order line item.
@property (nonatomic, retain) Trading_UnpaidItemType *unpaidItem
Discussion
Container consisting of details related to the type and status of an Unpaid
Item case. This container is only returned if there is an open or closed
Unpaid Item case associated with the order line item.
type : class Trading_UnpaidItemType
Declared In
Trading_TransactionType.h
variation
In a fixed-priced listing, a seller can offer variations of the same item.
For example, the seller could create a fixed-priced listing for a t-shirt
design and offer the shirt in different colors and sizes. In this case, each
color and size combination is a separate variation. Each variation can have
a different quantity and price. Due to the possible price differentiation,
buyers can buy multiple items from this listing at the same time, but all of
the items must be of the same variation. One order line item is created
whether one or multiple items of the same variation are purchased.
The Variation node contains information about which variation
was purchased. Therefore, applications that process orders
should always check to see if this node is present.
@property (nonatomic, retain) Trading_VariationType *variation
Discussion
In a fixed-priced listing, a seller can offer variations of the same item.
For example, the seller could create a fixed-priced listing for a t-shirt
design and offer the shirt in different colors and sizes. In this case, each
color and size combination is a separate variation. Each variation can have
a different quantity and price. Due to the possible price differentiation,
buyers can buy multiple items from this listing at the same time, but all of
the items must be of the same variation. One order line item is created
whether one or multiple items of the same variation are purchased.
The Variation node contains information about which variation
was purchased. Therefore, applications that process orders
should always check to see if this node is present.
type : class Trading_VariationType
Declared In
Trading_TransactionType.h
vatPercent
VAT rate for the item. When the VATPercent is specified, the item’s VAT
information appears on the item’s listing page. In addition, the seller
can choose to print an invoice that includes the item’s net price, VAT
percent, VAT amount, and total price. Since VAT rates vary depending on the
item and on the user’s country of residence, a seller is responsible for
entering the correct VAT rate; it is not calculated by eBay. To specify a
VATPercent, a seller must have a VAT-ID registered with eBay and must be
listing the item on a VAT-enabled site. Max precision 3 decimal places. Max
length 5 characters. Note: The View Item page displays the precision to 2
decimal places with no trailing zeros. However, the full value you send in is
stored.
Not applicable to Half.com.
@property (nonatomic, retain) NSNumber *vatPercent
Discussion
VAT rate for the item. When the VATPercent is specified, the item’s VAT
information appears on the item’s listing page. In addition, the seller
can choose to print an invoice that includes the item’s net price, VAT
percent, VAT amount, and total price. Since VAT rates vary depending on the
item and on the user’s country of residence, a seller is responsible for
entering the correct VAT rate; it is not calculated by eBay. To specify a
VATPercent, a seller must have a VAT-ID registered with eBay and must be
listing the item on a VAT-enabled site. Max precision 3 decimal places. Max
length 5 characters. Note: The View Item page displays the precision to 2
decimal places with no trailing zeros. However, the full value you send in is
stored.
Not applicable to Half.com.
type : NSNumber, wrapper for primitive double
Declared In
Trading_TransactionType.h