BPicture: Style fixes related to documentation.

Mostly pointer style adjustments
BPictureButton: Style fixes related to documentation

Some variable renaming for consistency.
Fill out documentation for BPicture class.
Fill out documentation for BPictureButton class.